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Preface 


The SunView 1 Beginner’s Guide helps you get started using SunView windows 
whether you’re a brand-new user or an expert. This manual is organized in two 
sections: 

□ The Lessons section takes you step by step through some of the most impor¬ 
tant window operations. You’ll acquire a working knowledge of SunView 
and be able to perfomi useful work when you’re done. 

□ The Reference section describes SunView fully, including many advanced 
features that are not covered in the lessons. After you’re comfortable with 
the contents of the lessons, it’s a good idea to read the Reference section 
carefully to add additional skills to your repertoire. 

If you’re new to SunOS™ and UNIXf operating system commands, make sure 
you read Getting Started with SunOS: Beginner’s Guide before you begin this 
manual. 

If you’re new to window-based systems, the lessons will get you started editing 
text and using SunOS command interpreters in a window environment. Win¬ 
dows are ftm to woik with — don’t be afraid to try things out! The lessons pro¬ 
vide a painless way to get started. 

Other manuals for beginners are: 

Mail and Messages: Beginner’s Guide 

Doing More with SunOS: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 

Self-Help with Problems: Beginner’s Guide 

If you’re an experienced user, you’ll probably want to jump right in...and you 
can. But do take time to skim the Reference section so you won’t miss out on 
some of SunView’s most attractive new features. You’ll find additional informa¬ 
tion on SunView and its tools in the SunOS Reference Manual, also known as the 
“Man Pages.’’ The SunOS Reference Manual is available online through the man 
command. 


t UNIX is a registered trademaric of AT&T. 
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Getting Started with SunView 


SunView is a window-based environment that lets you run SunOS command 
shells, editors, debuggers, and other tools, each in its own window or “frame.” 
SunView lets you look at several files or directories at the same time and mn 
several commands at the same time. 

This lesson teaches you how to: 

□ Enter the SunView environment from a SunOS command line. 

□ Use the three-button mouse. 

□ Work with icons, frames, windows, and menus. 

□ Select and edit text. 

□ Create and save a file, 
o End a work session. 

LI. Starting SunView To bring up SunView: 

The command prompt that appears □ Reply to the command prompt by typing the commands cd (for change 
throughout this manuai is venus%. directory) and sunview, as shown in Figure 1-1. Press the I Return) key 

after each command. 

Figure 1-1 Starting SunView from a SunOS Command Line 


—^— ---^— -^^^^^—_—__—^^ 

venus% cd 
venus% sunview 

C_________ — _ _> 


The cd command puts you in your home directory before starting SunView. The 
illustrations in this manual will be easier to follow if you start SunView from 
your home directory. 

For more information on cd and other SunOS commands referred to in this 
manual, see the SunOS Reference Manual, which is also available online through 
the man command. 

After a few seconds the screen turns gray and images appear one by one. This is 
the SunView startup screen. The top part of the screen is shown in Figure 1-2. 
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4 SunView 1 Beginner’s Guide LESSONS 


The rest of the startup screen is gray. The gray part is known as the background. 


Figure 1-2 Top of SunView Startup Screen 



NOTE If your System Administrator has customized your system, your SunView startup 

screen may not look exactly like this. 

The Tools at Startup On the gray background you’ll see five images: a wide rectangle and four small 

pictures. From left to right, these are: 

□ An open Console frame (where system messages are usually displayed). 

□ A Qock icon (a clock face — the hands move to display the time). 

□ A Command Tool icon (a nautilus shell with scrollbar). 

□ A Text Editor icon (a document with a pencil). 

□ A Mail Tool icon (a mailbox — the flag is up when there’s mail for you). 

Each of the images is ^ frame belonging to a tool, or window application pro¬ 
gram. The Console frame is open, and the other frames are closed. In other 
words, open frames display windows and closed frames are represented by icons. 
You’ll hear more about closed frames later in this lesson. When a frame is open, 
its windows are ready to receive input from the keyboard and mouse. You can 
close a frame to an icon and the command it’s processing continues to process. 

Frames can contain several windows. The Text Editor frame, which you’ll be 
learning about throughout this manual, contains two windows. The Console 
frame, described in the next section, contains only one. 
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Chapter 1 — Getting Started with Sun View 5 


The Console at Startup The Console is a Command Tool (a tool that contains a command interpreter) 

with a special function: this is where the SunOS operating system, SunView, and 
some applications display messages. For example, if you’re having network 
problems, the error messages appear in the Console window. That’s why it’s a 
good idea to leave the Console just as it is at startup. If you need a Command 
Tool, you can always open another one. You’ll find out how to do this in a few 
pages. 


1.2. The Mouse and the Look in the middle of the screen for a black arrow pointing “northwest.” 

Pointer 


Figure 1-3 The Pointer 



This arrow is known as the pointer. The mouse moves the pointer around the 
screen so that you can open icons, bring up menus, select text, and perform other 
SunView tasks. 

First make sure the mouse pad (the silver plate with the blue grid) is on the right 
of the keyboard with its wide side facing you. Place the mouse on the mouse 
pad: buttons up, red fight down, perpendicular to the wide side of the pad.^ 

To move the pointer, move the mouse around on its pad and note the correspond¬ 
ing movement of the pointer on the screen. Try that now. Your fingers should 
be resting comfortably on the mouse buttons, with the “tail” facing away from 
you. 

The pointer can take many shapes. No matter what shape the pointer is, it can be 
moved by the mouse. 


^ TTiis description of the optical mouse doesn’t apply to the mechanical mouse. If you have a mechanical 
mouse with a rolling ball on the bottom, you don’t have to align the mouse to the pad. 
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6 SunView 1 Beginner’s Guide LESSONS 


Figure 1-4 Moving the Mouse on Its Pad 



Left-Handed Mousing 


If you’re left-handed, you can use the mouse on the left side of the keyboard. 

You can also change the function keys so that the functions are accessible from 
the right side of the keyboard. With left-handed mousing, the LEFT mouse button 
is the one under your index finger, closest to the keyboard. See Qiapter 4, All 
About Keyboards, in the Reference section for more information about SunView 
options for left-handed users. 



What to Do When the Pointer If the pointer doesn’t respond to the mouse, try moving the mouse rapidly in 

Won’t Move large circles on the pad several times. This initializes the mouse. It should then 

start to control the pointer position. 

If the pointer still won’t move, check to make sure the mouse is plugged in to 
your workstation without a loose connection. If that fails to solve the problem, 
unplug the mouse from the workstation and plug it in again. 

If the mouse still doesn’t work, the mouse or the workstation may be defective -- 
contact your System Administrator. 


The Mouse Buttons Here’s how the three-button mouse works: 

□ The LEFT mouse button — LEFT for short — is used mainly to select text, 
open icons, and push buttons in panels and alert windows. 

□ The MIDDLE mouse button — MIDDLE for short — is used mainly to extend 
or adjust a selection, move a frame or icon, and scroll in a window. 

□ The RIGHT mouse button — RIGHT for short — is used mainly to bring up 
and choose from menus. 

There are two actions you can take with a mouse button: click or hold down. To 

try the buttons, first move the mouse so that the pointer moves into the Console 
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Chapter 1 — Getting Started with SunView 7 


window — the white rectangle on the top left of the screen. 

You click a mouse button by pressing and releasing it, similar to the way you 

type by pressing and releasing a key on the keyboard. 

□ With the pointer over the gray background, click the MIDDLE mouse button, 
just to see how it feels. (You can do this as many times as you like. Notli- 
ing will happen.) 

□ With the pointer still over the gray background, hold down the MIDDLE 
mouse button by pressing it (you’U hear a single click) and not releasing. 

Move the pointer around while continuing to hold down the ME)DLE mouse 
button. The pointer will change shape as it moves over different objects on 

the screen. Then release the mouse button. 

Holding down the mouse button while moving the pointer is a combination 
you’ll be using often in SunView. 


Bringing Up and Dismissing a Read this section before you try the instmctions it contains. It’s important to fol- 

Meeu low them exactly to avoid choosing a menu action you didn’t intend to choose. 

SunView tools don’t show you a menu until you request one. The location of the 
pointer determines which menu comes up. 


To bring up a menu, hold down the 
RIGHT mouse button. 


□ With the pointer in the white part of the Console window, hold down the 

RIGHT mouse button. Don’t let go until you either choose a menu action or 
dismiss the menu without making a request — you’ll learn how in this sec¬ 
tion. 


Figure 1-5 Bringing Up a Menu 



Fi le 


Edit 



M 

Find 


Extras 


Cmd Modes 



Figure 1-5 shows a menu — a list of actions you can request. The ‘Display=>’ 
menu item is highlighted. 

When a menu item is highlighted, it’s ready to be chosen. Highlighted text is 
displayed in inverse video (white characters on a black background). 
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8 SunView 1 Beginner’s Guide LESSONS 


When you want to choose an item in a menu, you move the pointer over the item 
so that it api^ars highlighted, then release the mouse button. But don’t do that 
yet. 


To dismiss a menu — close it without □ Keep holding down the RIGHT mouse button as you move the pointer left, 

taking any action — move the menu, so that no menu item is highlighted, 

pointer off the menu so that no 

menu item is highiighted, then □ Release the mouse button. The menu disappears, 

release the mouse button. 

You’ve successfully dismissed the menu without choosing a menu item. Now 
you’re ready to choose a menu item to close the Console frame. 

NOTE If your system has stay-up menus, things are a bit different. You click RIGHT to 

bring up a menu, and it stays up until you dismiss it or choose from it by clicking 
RIGHT again. Chapter 10 in the Reference section, The Defaults Editor, tells you 
how to get stay-up menus. The Lessons section chapters assume you have nor¬ 
mal menus. 


1.3, Opening and Closing 
Frames 


« CONSOLE » O 


venus% 


Most of the work you do in a tool is done with its frame open. You can’t really 
work in a closed frame, although you can start work (say, a compilation) and 
then close the frame. The Frame menu, one of the standard SunView menus, lets 
you open or close a frame, change its appearance, and quit the tool it belongs to. 

□ Move the pointer into frame header — the black stripe at the top of the 
Console frame where the word « CONSOLE » appears. 

Notice that the pointer changes shape. It’s now a target — a circle with a dot 
inside. The target means that you can bring up the Frame menu. The pointer 
appears as a target whenever it’s over a frame header, any part of a frame border, 
or an icon. 

The Console frame completely surrounds the Console window, so you can point 
anywhere on the border of the frame — not just in the frame header — to bring 
up the Frame menu. You can prove this for yourself: 

□ Move the pointer around the edge of the Console frame and notice that it 
remains a target shape as long as the pointer touches the frame border. 
(When you want to bring up a Frame menu, just point to the nearest edge of 
the frame border.) 

□ Move the pointer slowly across the screen to the right so that it passes over 
the icons. Whenever the pointer is on an icon, it takes a target shai^. This 
means you can bring up the Frame menu whether the frame is open or 
closed. 

□ Point again at the Console frame header, then hold down the RIGHT mouse 
button. The Frame menu appears, with ‘Close’ at the top and ‘Quit’ at the 

bottom. 

□ Keep holding down the RIGHT mouse button. 
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Figure 1-6 The Frame Menu 



When you bring up a menu, the pointer changes shape again. It’s now pointing 
directly “east.” 

□ Still holding down the mouse button, move the pointer slightly to the right 
until one of the menu items is highlighted. 

o Now move the pointer slowly up and down the list. Different items are 
highlighted. 

To close the Console frame, choose ‘Close’ from the Frame menu: 

□ Move the pointer over the ‘Qose’ menu item to highlight it. 

□ Release the mouse button. The frame closes to an icon like the one in Figure 
1-7. 

Did you notice that lines flashed from the comem of the Console frame to the 
place where the icon is now? You’ll see a similar effect when you open an icon 
— lines temporarily flash from the comers of the icon to the place where the 
open frame will be. These flash lines will help you locate the frame or icon on a 
crowded screen. 

Figure 1-7 The Console Frame Closed to an Icon 



console 


The Console icon went to the top of the screen because SunView’s default icon 
gravity is north. The icon gravity determines which edge of the screen an icon 
will “fall” toward when you close its frame. You can change the icon gravity by 

using the Defaults Editor, described in Chapter 10. 
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Toggles 

Grayed Menu Items 

1,4. Using the Text Editor 
Choosing a Menu Item 

To choose a menu item, highlight 
the item and release the mouse but¬ 
ton. 


Now bring up the Text Editor’s Frame menu. You’ve already learned how to do 
this: 

□ Move the pointer over the Text Editor icon so that the pointer becomes a tar¬ 
get. 

□ //oW the RIGHT mouse button. The Frame menu pops up. 

This is the standard way to get a Frame menu. From now on we’U just say, 
“Bring up the Frame menu.” You can do this whether the tool — (the Console, 
the Text Editor, or any other SunView application — is open (in window form) 
or closed (in icon form). 


The Frame menu for the Text Editor icon has ‘Open’ at the top, while the Frame 
menu for the Console frame has ‘Qose’ at the top. ‘Open’ and ‘Close’ toggle 
back and forth. You only see one aspect of a toggle at a given time. After you 
choose it, its opposite is listed in the menu. Toggles are common in SunView in 
menus and function keys, so you’ll be hearing more about them. 

□ Dismiss the Frame menu by moving the pointer off the menu (usually left¬ 
ward works best) until no menu item is highlighted, then releasing the 
mouse button. 


You may have noticed that the ‘Props’ menu item in the Frame menu is in gray, 
not black, letters. WTien a menu item is gray, it’s not available. It won’t 
highlight when you preview it, and you can’t choose it. 

‘Props’ is a feature that hasn’t yet been implemented in many SunView tools. 
Other menu items may be gray because they require a selection and there’s no 
current selection. (More on selections later.) 


It’s time to learn about text windows, but all the windows are closed, so let’s 
open some. 

It’s a good idea to keep the Console window open in case any messages appear, 
so open that window now: 

□ Bring up the Console icon’s Frame menu. 

□ Choose ‘Open’. 

From now on we’ll just say, “Choose ‘Open’ from the Frame menu.” 

□ Now open the Text Editor by choosing ‘ Open’ from the Text Editor’s Frame 
menu. 

Each frame has its own Frame menu, and each text window has its own Text 
menu. 

With the Console and the Text Editor both open, the screen should look like Fig¬ 
ure 1-8. 
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The Text Editor Frame 


Table 11-1 \n\he All About Tools 
chapter contains a list of SunView 
tools and their corresponding com¬ 
mand names. 

Text Windows 


Figure 1-8 


Let’s begin by taking a look at how the open Text Editor frame appears on the 
screen. 

Like the Console, the Text Editor tool has a frame with a frame header at the top. 
The name of the tool appears on the left side of the frame header. The name 
shown is the command name by which the tool is known to the SunOS system. 


Unlike the Console frame, which contains only one command window, the Text 
Editor frame contains two text windows shown in Figure 1-8: 

□ The small scratch window just under the frame header is used as a work area 
for filenames, directory names, and other short text items. 

□ The large edit window below the scratch window is used to display the file 
you’re editing. The text in the edit window is known as the document. 


An Open Text Editor Frame 
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The scratch window and the edit window are both text windows. Each has 
slightly different properties, but they have a lot in common. 
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The Text Menu 


Previewing a Menu 


One thing all text windows have in common is the Text menu. Almost every¬ 
thing you learn about woridng with the Text Editor can be applied to text win¬ 
dows in other tools. The Mail Tool has two or more text windows, the Defaults 
Editor has one, and so on. Although the Console window is a command window, 
it also has a Text menu. The Text menu in command windows contains some 
additional menu items. 

If the menu associated with a window looks like the one in Figure 1-9, it’s a Text 
menu. (The resemblance doesn’t have to be one hundred percent. The Console 
window’s Text menu contains an extra line, but it’s still a Text menu.) AH Text 
menus contain ‘File=>’, ‘Edit=>’, ‘Display=>’, ‘Find=>’, and ‘Extras=>’ menu 
items. 


To preview a menu, hold down the RIGHT mouse button, then highlight the menu 
items. When you’re finished previewing, either choose a menu item or dismiss 
the menu. 

One reason for previewing is to examine the puU-right menus. A pull-right menu 
is a menu that belongs to a menu item with a puU-right symbol (=>) at the end of 
its name, such as ‘File=>’. 

□ To preview a pull-right menu, highlight the puU-right menu item, then move 
the pointer to the right and highlight its menu items. 

Another reason to preview a menu is to find out which menu items require a 
selection. (More about selections later.) 

o Move the pointer into the scratch window and preview its Text menu. 

Notice that the puU-right menus contain pull-right menus of their own. Pre¬ 
view them too. When you’re done previewing, dismiss the Text menu 
without choosing an item (move the pointer back to the left so that no menu 
item is highlighted, then release the mouse button). 

□ Move the pointer into the edit window, preview its Text menu, then release 
the mouse button. 

o Move the pointer into the Console window, preview its Text menu, then 
release the mouse button. Notice that the Text menu in the Console window 
has an extra puU-right menu at the bottom, ‘Cmd Modes=>’. 
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Figure 1-9 Previewing the Text Menu 


textedit -4(N0NE), dir: /usr/nutmeg/sages 




Scratch uindoui 


File 



_, 

Again 

Display 


FI nd 


Extras 

Paste 

s;.::.;;-.-.: TETIT: 

Cut 


Show Clipboard=!> 

Copy Hum Posto 


The Keyboard Focus It’s time to begin typing. But wait a minute — there are three open windows. 

Where will the typing go? 

The window that receives whatever you type is said to have the keyboard focus. 
There are three ways to tell which window has the keyboard focus: 


□ The window border thickens. When a window receives the keyboard focus, 
its border changes to a bold black line. When the keyboard focus is not in 
the window, its border is a thin line. 


Click-to-type is a different way of 
setting the keyboard focus. See 
Chapter A, All About Keyboards, for 
more information. 

o The caret blinks. The insertion point — the place in the text window that 
receives the next character you type — is marked by a small black blinking 
triangle. This triangle is known as the caret. When the keyboard focus is 
not in the window, its caret appears as an unblinking gray diamond. (This is 
not true in canvases or tty windows, which are described in Chapter 5, All 
About Frames and Windows, in the Reference section.) 

To see how the keyboard focus works, try these experiments: 


□ The pointer is in the window. The way you change keyboard focus is to 
move the pointer. If the pointer is not in a text window — if it’s on a frame 
or on the background or in a window that can’t receive text — whatever you 
type is lost. 


Before typing, make sure the key¬ 
board focus is in the correct win¬ 
dow. To set the keyboard focus in 
a window, move the pointer into the 
window. 


□ Move the pointer into the edit window, the large window in the Text Editor 
frame. Notice that its caret is blinking and its border is black. The pointer 
can be anywhere in the edit window. 

□ Type your first name. It appears at the upper left comer of the edit window, 
because that’s where the caret was. The caret moves to a point just after 
your name. 

□ Move the pointer into the scratch window. (The pointer is almost as tall as 
the window — make sure the tip of the pointer is in the window.) The edit 
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Make sure the pointer is in a text 
window before you start typing, or 
whatever you type will be lost. 


The Delete Key 


You can change the backspacing 
key from ( Delete I to ( Back Space 1 
with the Defaults Editor, described 
in Chapter 10 in the Reference sec¬ 
tion. 


The ‘File=>’ Pull-Right Menu 


window loses its ix)ld border. Its caret turns gray, changes to a diamond, 
and stops blinking. 

o Type your last name, making sure the scratch window has the keyboard 
focus. Your name appears in front of the words S cr at ch window, with 
the caret at the end of your name. 

□ Move the pointer onto the clock icon so that the pointer shape becomes a tar¬ 
get. Type your nickname. Look in aU the windows and you won’t see your 
nickname anywhere. When no window has the keyboard focus, what you 
type goes nowhere. 


It’s time to type something else in the edit window, so let’s get rid of what’s 
there now. There are several ways to do this. (There are several ways to do 
almost everything in SunView. That makes it a bit harder to learn, but nice to 
work with because you get to use it just the way you prefer.) 

[ Delete I is the default key for erasing the character to the left of the insertion 
point. You’U find it on the right side of the alphanumeric part of the Type4 key¬ 
board, above the I Return I key. Other keyboards have a [ del I key — it’s the 
same thing. 

If you’re not sure which keyboard you have, see Chapter 4, All About Keyboards, 
for drawings of the various keyboards and instructions on how to label a Type2 
or Types keyboard to match the Type4 keyboard references in this manual. 

□ Move the pointer into the edit window, where you typed your first name a 
few minutes ago. 

□ Press the I Delete I key once, and the last letter of your name disappears. 
Unless your name has only one letter, press the I Delete I key again until aU of 
the name is erased. 

□ Now erase your last name from the scratch window. Hint: Remember to 
move the keyboard focus first. 


When you previewed the Text menu, you discovered that a puU-right menu can 
contain lower-level pull-right menus. The ‘File=>’ puU-right menu is three levels 
deep. It’s called the ‘File=>’ pull-right menu because you bring it up by pulling 
the pointer to the right of the ‘File=>’ menu item in the Text menu. 

Here’s a way to use the ‘File=>’ pull-right menu to erase aU the text in a window. 

□ With the pointer in the edit window, type your name again. Now you’re 
going to erase it by choosing a menu item. 

□ Bring up the Text menu. 

□ Highlight the ‘File=>’ menu item by moving the pointer onto it. 

□ Move the pointer slightly to the right. The Tile=>’ pull-right menu appears, 
with ‘Save Current File’ at the top and ‘Finishing Up=»’ at the bottom. 
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Alert Windows 


□ Choose ‘File=>Empty Document’, as shown in Figure 1-10. ‘File=»Empty 
Document’ is shorthand for “the ‘Empty Document’ menu item in the 
‘File=^’ pull-right menu.” 

You choose a menu item in a pull-right menu the same way you choose ‘Open’ 
and ‘Qose’ from the Frame menu: by moving the pointer over the item so that 
it’s highlighted in inverse video, then releasing the mouse button. 


Figure 1-10 The 'File=^’ Pull-Right Menu 
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‘Empty Document’ tells the Text Editor to give you a fresh start: 

□ If you’re creating a new file, the Text Editor throws away the editing you did 
in memory. 

□ If you’re working on an existing file, the Text Editor throws away your edits 
(since the last time you saved the file) and forgets the file name. The file 
itself is stiU on the disk — ‘Empty Document’ doesn’t remove it. 


When you choose ‘Empty Document’, the Text Editor alerts you to the fact that 
you have made some changes in the text window that you haven’t saved. It 
beeps and brings up the following message: 


Figure 1-11 An Alert Window 



The arrow alerts you to read what’s in the box. The lozenge-shaped buttons at 
the bottom of the alert window give you the opix)rtunity to choose an action. All 
alert windows in SunView work this way. 
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□ The Confirm, discard edits button tells the Text Editor to empty the win¬ 
dow and forget the file without saving the changes you’ve made. This but¬ 
ton, the yes choice, has a double outline. The pointer moves automatically 
to the button with the double outline to make it easy to respond yes. 

□ The Cancel button tells the Text Editor to cancel the ‘Empty Document’ 
request and preserve your changes. 

You choose an action in an alert window by pushing a button. Since you’U 
remember your name even if the Text Editor forgets it, it’s okay to push the 
Confirm button. 

Here’s how to push a button in an alert window: 

□ Move the pointer over the button you want to push. In this case. Confirm, 
discard edits is the yes choice, so the pointer has already been automatically 
moved there. 

□ Click the LEFT mouse button. The alert window disappears, and your name 
is gone from the text window. 

1.5. Selecting Text You’ve learned how to erase text. There are also ways to delete text. The differ¬ 

ence is that deleted text is saved on the Clipboard. (More about the Clipboard in 
a few pages.) 

You can delete a selection by using: 

□ The ‘Edit=^’ pull-right menu (described below). 

D The 1 Cutl function key (described in the next lesson). 

□ An accelerator — a menu choice made from the keyboard. (These useful 
shortcuts are described in the Reference section in Chapter 9, All About 
Accelerators). 

We can’t really discuss selections until there’s some text to select, so let’s enter 
some. 

□ Move the pointer into the edit window and type the following limerick. 

Press f Return 1 at the end of each line. Press (Tab 1 to begin an indented line. 


All Hail, Electronic Mail! 

There once was a workstation fan 
Who networked, but only on LAN— 

Till he chanced to discover 
An Ethernet lover— 

Now he's linked by e-mail to Japan. 


Don’t worry if you made some typing errors. You’re about to learn how to make 
editing corrections. When you’re done, the edit window looks something like 
Figure 1-12. 



Revision A of 9 May 1988 







Chapter 1 — Getting Started with SunView 17 


Selecting a Word 


Figure 1-12 The Electronic Mail Limerick 
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All Hail, Electronic Mai 1 ! 

There once luas a workstation fan 
Who networked, but only on LAN— 

Till he chanced to discover 
An Ethernet lovei— 

Now he's linked by e-mail to Japan. 


The caret (the blinking black triangle) is now positioned after the period follow¬ 
ing the word Japan . Whenever you enter text from the keyboard, the caret 
moves to a point just after the last character you entered. 

Suppose you want to change Japan to Siam . You can press the (Delete 1 key 
repeatedly until Japan is deleted and then type Siam. But that won’t work if 
you want to change a word at the beginning of the text. 

You can change any part of the text by selecting it, deleting it, and typing the 
replacement. To select text, you move the pointer over the text and click LEFT. 

To change a word anywhere in the text: 

□ Move the pointer so that the head of the arrow is anywhere in the word. 

o Double-click the LEFT mouse button to select the word. The selection is 
highlighted. 

Double-click means click twice in rapid succession. You click to select a 
character, double-click to select a word, triple-click to select a line, and 
quadruple-click to select aU the text in a document. 

□ Bring up the Text menu and choose ‘Cut’ from the ‘Edit=>’ pull-right menu. 
The word is removed from the window. 

o Type the replacement. 

Now try replacing Japan with Siam by following the instructions you just read. 
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Extending the Selection 


The MIDDLE mouse button is used to 
extend a selection. 


The MIDDLE mouse button is used to extend a selection by adjusting its length. If 
you selected a word by double-clicking the LEFT mouse button, the selection is 
extended in units of a word. If you selected a line by triple-clicking the LEFT 
mouse button, the selection is extended in units of a line. 

To get an idea of how extending a selection works: 

□ Select the word There at the beginning of the limerick by double-clicking. 

□ Move the pointer to anywhere in the word wa s and click the MIDDLE mouse 
button once. The selection There once was is highlighted. 

□ Delete the selection by choosing ‘Cut’ from the ‘Edit=>’ puU-right menu. 

o Type I once knew to replace the deleted text. The result is shown in 
Figure 1-14. 


Figure 1-14 Result of Cutting and Typing 


▼ Scratch ujindotu 
^All Hail, Electronic Mai 1 ! 

I once knew a workstation fan 
Who networl^ed, but only on LAN— 

|[. I Till he chanced to discover 

I'I An Ethernet lovei— 

y Now he's linked by e-mail to Siam. 

You can also extend a selection by wiping the pointer through the text in either 
direction while holding down the MIDDLE mouse button. The adjustment 
becomes final when you release the mouse button. You can adjust a selection as 
often as you like by wiping or clicking MIDDLE. 
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More About Selections 


Where you click determines which 
end of the selection gets the caret. 


Inserting Text 


The caret shows the position of the 
insertion point. 
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When you move the insertion point by pointing and clicking LEFT, you automati¬ 
cally select a single character. 

□ Try clicking LEFT various places in the text. A single character is 
highlighted each time. The character can be a space, a Return character 
(which looks like a space), or a Tab character (which looks like several 
spaces). 

Whether you select a character, a word, or a Une, the caret api^ars at the end 
closest to where you clicked. To see how this works: 

□ Select the word workstation by pointing to the beginning of the word 
and double-clicking LEFT. The caret appears before the w. 

o Select the word networked by pointing to the end of the word and 
double-clicking LEFT. The caret appears after the d. 

Imagine a vertical line precisely in the center of the text to be selected. If you 
click anywhere to the right of the center, the right end of the selection gets the 
caret, and vice versa. 

□ Try double-clicking LEFT in a word and see how close you can get to the 
center before the caret switches sides. 

□ Try the same experiment with a single character by single-clicking LEFT. 

There are also some very useful editing shortcuts that work with secondary selec¬ 
tions, which are temporary selections you make while holding down a function 
key. They’re covered in the Reference section in Chapter 6, All About Selections. 


If you’re just going to delete the word you selected, you won’t care which end 
the caret is on. But if you’re going to insert text instead of deleting, you can use 
the position of the caret to help you. 

To move the insertion point to the teginning of the line, you can carefully move 
the pointer in front of the first word and click, or you can point anywhere in the 
first half of the line and triple-click, which may seem a lot easier. Try it both 
ways and see which you prefer. 

Change the first line of the limerick to read. Gee, I once knew a 
workstation fan: 

□ Move the pointer somewhere near the beginning of the first line and triple¬ 
click the LEFT mouse button. 

□ Type Gee, . 

In SunView, you can choose the way that’s easiest for you. Once you’ve used 
SunView for a while, you may decide to change to a different style of working. 
That’s why it’s a good idea to read the Reference section and become familiar 
with aH the options available to you. 
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Extending the Selection 
Backward 


More About the 
Pull-Right Menu 


You’ve seen how to extend a selection forward, but you can extend it backward 
just as easily. 

a Double-click LEFT to select the word fan in the first line of the limerick. 

□ Move the pointer to the word workstation and click MIDDLE to extend 

the selection backward. The phrase workstation fan is highlighted. 

You’ve seen how to choose *Edit=>Cut’ to delete text. ‘Copy’ and ‘Paste’ are 
related to ‘Cut’. They all use the Qipboard. 


The Clipboard 


If the text on the Clipboard is long, 
‘Edit=>Show Clipboard’ shows only 
the first several characters. 


The Clipboard is a temporary storage area where text windows place text that 
you copy or cut. Remember the way your typing was lost when there was no 
keyboard focus? When you delete text by choosing ‘Cut’ from the ‘Edit=»’ 
pull-right menu, it isn’t lost. Instead, the deleted text is placed on the Qipboard. 

□ To look at the Qipboard, preview ‘Show Qipboard =>’ from the ‘ Edit=^’ 
pull-right menu. (You don’t actually have to choose ‘Show Qipboard =>’ by 
releasing the mouse button in order to see the Qipboard contents. You can 
simply preview the contents by pulling right on the menu item.) 

‘Show aipboard=>’ displays the last selection you cut or copied. If you’ve been 
following the lesson, you should seethe words There once was, as in Figure 
1-15. 


Figure 1-15 Showing the Clipboard 
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To put text on the Qipboard, select the text, then choose ‘Edit=:>Copy’: 

□ Select the word Ethernet. 

□ Choose ‘Edit=>Copy’. The selection is copied onto the Qiptx)ard. 
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o Now choose *E(iit=>Show Clipboard=»’. There it is. 


‘Copy’, ‘Paste’, and ‘Cut’ ‘Edit=>Copy’ puts the selection on the Clipboard. ‘Edit=>Cut’ deletes the selec¬ 

tion and puts it on the Clipboard. ‘Edit=>Paste’ inserts the contents of the Clip¬ 
board at the insertion point. So.... 

To move text fiom one place to another: 

□ Select the text. 

o Choose ‘Edit=>Cut’. Now the deleted text is on the Qipboard. 
o Click LEFT to set the insertion point where you want the text moved to. 

□ Choose ‘Edit=>Paste’. The text on the Qipboard is pasted at the caret. 

The first line of the limerick contains the phrase I once knew. Change it to 
once I knew: 

o Cut once . (Include the space after once by extending the selection.) 

□ Paste in front of I knew. Now the line reads. Gee, once I 
knew.... 


You can paste repeatedly from the Now paste the contents of the Clipboard before the word knew so the line reads 
Clipboard. Gee, once I once knew .... 

□ Move the caret to the right of the space between i and knew. 

□ Paste. 

The Qipboard won’t change until you choose ‘Cut’ or ‘Copy’ again. 


Some Menu Items Require a Open the ‘Edit=^’ pull-right menu. Notice that ‘Copy’ and ‘Cut’ appear in light 

Selection gray letters. And they’re not highlighted when you preview the menu. Usually a 

menu item is grayed because it requires a selection and there isn’t one currently. 
For example, after a ‘Paste’ operation there’s no current selection. 


Figure 1-16 Copy and Cut Require a Selection 
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Select some text — you might try quadruple clicking to select the entire limerick 
— and preview the ‘Edit=>’ pull-right menu again. Now ‘Copy’ and ‘Cut’ are 


Asun 

microsysSems 


Revision A of 9 May 1988 




22 SunView 1 Begiimer’s Guide LESSONS 


available because there’s a selection. 


1.6. Saving a New File Now that you’ve made a wonderful limerick even better, wouldn’t you like to 

keep it so you can read it for inspiration on stressful days? 

To save the contents of a text window: • 

□ Type the filename of the new file. Let’s name it lessonl. limerick. 
The Text Editor’s scratch window is handy for that purpose, as shown in 
Figure 1-17, but you could type the filename in the Console window or any¬ 
where else in SunView that can receive text. 

o Select the filename you tyjKid. You’ll need to extend the selection with the 
MIDDLE mouse button to select the whole name. 

NOTE Be sure to move the pointer back into the edit window. If the pointer is in the 

scratch window, the contents of the scratch window, not the edit window, will be 
saved. That’s probably not what you want. 

□ In the edit window, bring up the Text menu and choose 
‘File=»Store as New File’. 


Figure 1-17 Saving a New File 


textedit - (NONE 


Scratch windouj 
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An Ethernet 
Now he''s linked by 


Save Current File 


Edit ^ 

Displa^ 

Find 

Extras 


Store as New File 


Load Fi le 

Include File 

Set Directory 


Enptf Pocuraent 
Finishing Up 


The name of the file you saved now appears on the left side of the frame header. 
This is the file your text will be saved to when you choose ‘File=>Save Current 

File’ later in this lesson. 
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Figure 1-18 Filename in the Frame Header 


textedit lessonl.limerick, dir: /home/nu 

esson 1.1 imerick 


*|A11 Hail, Electronic Mai 1! 

Gee, once I once knew a workstation fan 
II Who networked, but only on LAN— 

Till he chanced to discover 
An Ethernet lover— 

Now he''s linked by e-mail to Siam. 


About the Directory On the right side of the frame header in Figure 1-18, you’ll see dir : followed 

by the name of the directory where the limerick file was saved. That’s the 
default directory for the Text Editor frame. The Text Editor uses the default 
directory when you load or store a file with a partial pathname. 

On your workstation, the default directory is your own home directory. If you 
want to save the file to another directory, you can do it in one of two ways: 

□ You can type the fiill pathname of the file in the scratch window, beginning 
with a slash (/), and select that pathname for ‘Store as New File’. If you do 
this, the default directory wiU stiU be your home directory, but when you 
choose ‘Save Current File’ you’ll save to the full pathname you specified. 

o If you want to change the default directory, you can select the new directory 
name and choose ‘File=^Set Directory’. The new name will appear on the 
right side of the frame header. 

For more information on setting the directory, see the ‘File=»Set Directory’ 
menu item in the All About Menus chapter. 


Undoing Edits The Text Editor lets you know when the current file has been edited. 

□ Select All Hail in the limerick title. 

□ Choose ‘Edit=>Cut’. 

□ Type Oh Swell to replace words you cut. 

The frame header now contains the word (edited) after the filename. 

As soon as you change the text in a text window after saving the file, the frame 
header shows that the file has been edited as shown in Figure 1-19. This can 
serve as a reminder to save your file. It’s a good idea to do that fairly often. 
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Figure 1-19 The File Has Been Edited 


textedit ” lessonl.limerick (edited), dir: 


t Scratch.uindow lessonl.1imerick 

^ ....... .. ^ 

Oh Swell, Electronic Mail! 

Gee, once I once knew a workstation fan 

The Text Editor (or any application that uses the Text menu) lets you change 
your mind by undoing edits. 

To remove the words you just typed: 

□ Choose ‘Undo=»Undo Last Edit’ from the ‘Edit==>’ puU-right menu. The 
line disappears. The word (edited) in the frame header also disappears. 

‘Undo Last Edit’ undoes the most recent edit action. It can undo: 

o ‘Paste’, ‘(Sut’, or ‘Again’ in the ‘Edit=»’ puU-right menu. 

o Typing, including pressing the I Delete) key. Everything you typed since the 
last selection is undone. (Remember, clicking to set the insertion point 
makes a one-character selection.) 

CAUTION It’s possible to accidentally undo a great deal of typing at one fell swoop, so 

be careful. You can’t undo ‘Undo’! 



1.7. The SunView Menu The location of the pointer determines which menu comes up when you hold 

down the RIGHT mouse button. If the pointer is in a text window, the Text menu 
comes up. If it’s on a frame or an icon, the frame menu comes up. If it’s on the 
gray SunView background, the SunView menu comes up. 

Figure 1-20 The SunView Menu 



The SunView menu lets you start all the tools you now have — Mail Tool, Text 
Editor, Command Tool, Console, and Clock — and provides several other handy 
tools and services. 

NOTE You should never have more than one Console tool running. 
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Printing from the SunView One of the services in the SunView menu gives you an easy way to print the 
Menu selection. 


Figure 1-21 Printing the Selection 



To print the limerick: 

□ Select the limerick by quadruple-clicking in the edit window. The entire 
document is highlighted. 

□ Choose ‘Print Selected Text’ from the ‘Services=^Printing=»’ pull-right 
menu. Selection printed will appear in the Console window — 
don’t make another selection until you see this message. 

□ Go to your local printer and pick up your poem. (If you don’t know which 
printer has been assigned to your workstation, ask your System Administra¬ 
tor.) 


Locking the Screen Ready to take the limerick and run? Before you head out the door, there’s just 

one more thing to do. If you leave your workstation screen up for long periods of 
time without changing the display, the image will “bum” into the tube and make 
the screen hard to read. That’s one reason why it’s a good idea to lock the screen 
before leaving work. ‘Lock Screen’ displays a moving image that protects the 
screen. 

Another reason to lock the screen is to protect your privacy. You can leave all 
your frames open in SunView, and ‘Lock Screen’ will keep idle passersby from 
reading their contents. No one can unlock your screen without knowing your 
password. 
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When you're ready to end this lesson: 

□ Bring up the Text Editor’s Text menu and choose ‘Save Current File’ from 
the ‘File=»’ puU-right menu. Always save your work when you’re going to 
be away from your workstation for a while. 

□ Choose ‘Empty Document’ from the ‘File=>’ pull-right menu. This isn’t 
usually necessary, but it gives you a clean start for the next lesson. 

□ Choose ‘ Qose’ from the Frame menu to prepare for the next lesson. Nor¬ 
mally you would keep frames open. 

□ Bring up the SunView menu. 

□ Choose ‘Lock Screen’ from the ‘Services=>’ pull-right menu. Your screen 
gets daik, as shown in Figure 1-22. 

Figure 1-22 The Locked Screen 



At the beginning of the next lesson, you’ll learn how to unlock the screen. 
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Sun View Accelerated 


In the first SunView lesson, you learned how to perform window operations 
using menus. This lesson teaches you how to use accelerators that make Sun- 
View operations faster and easier. You will learn how to: 

□ Use SunView shortcuts. 

□ Load a file in the Text Editor. 

□ Make frames larger or smaller and move them around. 

□ Look at different parts of a document in a window by scrolling. 

□ Find and replace text. 

□ Use panels to make choices and perfomi actions. 


2.1. Introduction to Many SunView actions can be initiated in more than one way. Some alternative 

Accelerators methods are known as accelerators because they’re faster than the standard tech¬ 

nique. There are accelerators that let you perform menu operations from the key¬ 
board, accelerators that let you move the caret from the keyboard, and accelera¬ 
tors that use the mouse and the keyboard instead of a menu. 

You can start using a few accelerators right away and add more to your repertoire 
as you become accustomed to SunView. In this chapter you’ll learn how to use a 
few of the powerful accelerators that are available. There are many more, and 
they’re covered in the Reference section in Chapter 9, All About Accelerators. 


»su 

mif*prkeiKs 


micros ystems 


29 


Revision A of 9 May 1988 




30 SunView 1 Beginner's Guide LESSONS 


2.2. Unlocking the Locked You ended the first lesson by locking the screen to ensure privacy while preserv- 
Screen ing the state of your windows. To unlock the screen: 

□ Click any mouse button or press any key except f FI) or (Taps I . The screen 
changes from black to white and a password prompt appears, as shown in 
Figure 2-1. 

Figure 2-1 Unlocking the Screen 


Name: sages 
Password: 

A 


Enter passyord to unlock; select square to lock. 



if you change your mind and want 
to relock the screen, click left in 
the black box. 


□ To unlock the screen, type your password, then press the I Return I key. The 
words Validating login. . . . apf^ar. 

If your password was correctly typed, the SunView screen appears, just as you 

left it. If you made a typing error, Lock Screen gives you another chance to enter 
the correct password. 
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23, Working with Several 
Frames 



In the previous lesson, you had two frames open at the same time: the Console 
frame and the Text Editor frame. They didn’t overlap, and the Console frame 
was up in the comer, out of the way. Often in SunView you will have several 
frames open at the same time, and working with them requires some window 
management techniques. 

Let’s get some frames open and woik with them. 

□ Move the pointer to the Text Editor icon. 

□ Choose ‘Open’ from its Frame menu. 



/bin/csh 


Now open the Command Tool using a point-and-click accelerator for Open: 

□ Move the pointer to the Command Tool icon. 

□ Click the LEFT mouse button. You can open any frame by clicking LEFT on 
its icon. 

The SunView screen now contains three open frames, as shown in Figure 2-2: the 
Console frame, a Text Editor frame, and a Command Tool frame. 


Figure 2-2 Three Open Frames 
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The Command Tool frame overlaps the Text Editor frame. You can type in any 
open frame regardless of whether it’s overlapped, by moving the pointer into its 
window. 

□ Move the pointer into all of the open windows, including the Text Editor’s 

scratch window, one at a time. Notice how the keyboard focus moves with 
the pointer — the window border darkens — even if the window is partly 
hidden. 


^Back’ and ‘Front’ The ‘Back’ and ‘Front’ menu items in the Frame menu let you manage the over¬ 

lap of frames. 

□ ‘Back’ hides the overlapping part of a frame by moving the frame to the 
back. 

□ ‘Front’ exposes the overlapped part of a frame by moving the frame to the 

front. 

To change the overlap of a frame, move the pointer onto the frame border and 
choose ‘Back’ or ‘Front’ from the Frame menu. 

NOTE Its possible for a frame to be completely hidden. To rescue a small frame from 
the back, send all the visible frames to the back by choosing 'Back’ for each one, 
and the hidden frame will float to the front. 

Try exposing the Text Editor frame, which is partly hidden: 

a Move the pointer onto the frame border of the Text Editor frame. 

□ Choose ‘Front’ from the Frame menu. The overlap changes, as shown in 
Figure 2-3. 
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Figure 2-3 Exposing a Partly Hidden Frame 



You could have performed the same action by choosing ‘Back’ from the Com¬ 
mand Tool’s Frame menu. If you have several layers, though, keep in mind that 
‘Front’ sends a frame aU the way to the top, and ‘Back’ sends it all the way to the 
bottom. 


At the left side of your keyboard are the ten main function keys. These 

keys act as accelerators that enable you to perform various menu operations 
without opening a menu. Some additional keys on the top and right side of the 
keyboard perform special functions in SunView; they’re described in Chapter 9, 
All About Accelerators. 
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Table 2-1 The Left Function Keys 


Key 

Menu Item 

Menu 

rstopi 

none 

— 

l Props j 

‘Props’ 

Frame 

IFrpntJ 

‘Front’, ‘Back’ 

Frame 

(Open) 

‘Open’, ‘Close’ 

Frame 

f Find 1 

‘Find=>Find Selection=:>Forward’ 

Text 


‘Find=>Find Clipboard=»Forward’ 

Text 

(Again 1 

‘Edit=> Again’ 

Text 

{Undo 1 

‘Edit=>Undo=>Undo Last Edit’ 

Text 

1 Paste I 

‘Edit=»Paste’ 

Text 

(CopyJ 

‘Edit=»Copy’ 

Text 

(Cut! 

‘Edit=»Cut’ 

Text 


Among the function keys described in Table 2-1, you’ll find accelerators for 
‘Copy’, ‘Paste’, and ‘Cut’ as well as ‘Open’ and ‘Front’. Some of the function 
keys accelerate the ‘Edit=>’ and ‘Find=^’ pull-right menus in the Text menu, 
while others accelerate the Frame menu. The keys are marked with the names of 
the lowest-level menu items.^ 

Back and Front accelerators. Pressing a function key is the equivalent of opening a menu and choosing an 

item. Some function keys toggle just as some menu items toggle. The f Open ] 
function key toggles to Qose, and the 1 Front 1 function key toggles to Back. 

□ Move the pointer anywhere in the Text Editor frame (not just the frame 
border) and press the i Front I function key. The Text Editor frame moves to 
the back, behind any overlapping frames. 

o Press (Front 1 again. The Text Editor frame comes forward again. 


Moving and Resizing Frames ‘Move=>’ and ‘Resize=>’ in the Frame menu let you change the location and size 

of a frame. You’U learn how to do this from the menu and by using accelerators. 

When you move or resize a frame, an empty rectangle known as the bounding 
box shows you the new fwsition. As long as you continue to hold down the 
mouse button, you can continue to adjust the position of the bounding box. The 
frame moves to the position of the bounding box when you release the mouse 
button. 

‘Unconstrained’ — the default in the ‘Move=:»’ and ‘Resize=»’ puH-right menus 
— lets you adjust both dimensions, height and width, at once. In unconstrained 


^ There are two reascms why your function keys may not look or work as described in this section: either 
you don’t have a Type4 keyboard, or your function key functic»is have been remapped (custcsnized). 

Chapter 4, All About Keyboards, shows you the differences among Type2, Type3, and Type4 keyboards, and 
tells you how to customize — or uncustomize — your keyboard. Left-handed people can customize the 
keyboard layout so that the functicms can be accessed from the right side of the keyboard. 
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resizing, the part of the frame border you grab becomes the movable comer of 
the bounding box. You grab the frame by moving the pointer over a part of the 
frame border and holding down the MIDDLE mouse button. 

A ‘Constrained’ move or resize lets you adjust only one dimension, either height 
or width. The direction the frame moves depends on where you grab it with the 
pointer. If you grab the frame when the pointer is on a side, the frame moves 
sideways. If you grab it when the pointer is on the top or bottom edge, the frame 
moves up and down. 


Here are the general rules for resizing a frame: 

1. Choose ‘Unconstrained’ (the default) or ‘Constrained’ from the ‘Resize=>’ 
pull-right menu in the Frame menu. 

2. Grab the frame by moving the pointer onto the frame border, then holding 
down the MIDDLE mouse button. 

3. Drag the frame with the pointer while continuing to hold down the MIDDLE 
mouse button. (Reminder: The MIDDLE mouse button is for extending, 
adjusting, and moving SunView objects.) 

4. Release the mouse button when the bounding box is at the location you want 
the frame to move to. 


2.4. Rearranging the 
Screen 
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Step One 


Let’s rearrange the screen so that it looks like the one shown a few pages ahead 
in Figure 2-8. You can try this on your own, or you can follow the detailed 
instructions below. 

o Choose ‘Resize=>Constrained’ from the Text Editor’s Frame menu. The 
following alert window appears: 

Figure 2-4 'Resize=>’ and 'Move=>’ Alert Window 







Press and hold the middle mouse button 
near the side or corner you want to resize 
and hold the button down while adjusting 
the bounding box to the shape you want; 
then release the mouse button. 

Otherwise, push "Cancel" button. 


Following the instructions in the alert window, grab the bottom edge of the 
Text Editor frame and shrink it by about one-third, as shown in Figure 2-5. 


Figure 2-5 Rearranging the Screen—Step 1 
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Step Tivo 


To move an icon or open frame to a new position on the screen: 

1. Choose ‘Move=>Unconstrained’ or ‘Move=>Constrained’ from the Frame 
menu. 

2. Drag the frame with the pointer while holding down the MIDDLE mouse but¬ 
ton. 

3. When the bounding box shows the location you want the frame to move to, 
release the mouse button. 

Here’s the second step in detail: 

□ Choose ‘Move=>’ from the Text Editor’s Frame menu. (‘Unconstrained’ is 
the default.) 

□ Following the instructions in the alert window, grab anywhere on the Text 
Editor frame border and drag the frame down to the bottom right comer of 
the screen, as shown in Figure 2-6. 

Figure 2-6 Rearranging the Screen—Step 2 
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Step Three 


The accelerator for ‘Move=>’ is to drag the frame while holding down the MID¬ 
DLE mouse button. 

The accelerator for ‘Resize=>’ is to drag the frame while holding down the 
[ Control I key and the MIDDLE mouse button. 

NOTE Moving and resizing with accelerators is constrained if you grab the frame 
border near the middle of a side, unconstrained if you grab it near a corner. 

Now let’s resize and move the Command Tool frame, using accelerators instead 

of the Frame menu: 

□ Hold down the f Control I key while you resize the Command Tool frame. 

□ Move the pointer to the middle of the bottom edge of the Command Tool 
frame and hold down the MIDDLE mouse button to grab the frame. 

□ Drag the bottom edge upward until it’s above the Text Editor’s frame 
header, as shown in Figure 2-7. 

□ Release the fControll key and the mouse button. 


Figure 2-7 Rearranging the Screen—Step 3 
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Final Step 


All that’s left to do now is to use an accelerator to move the Command Tool 
frame to its final position. 

o Move the Command Tool frame to the right by grabbing the middle of the 
right border and dragging to the location shown in Figure 2-8. 


Figure 2-8 Rearranging the Screen—Final Step 



One advantage of the new arrangement is that the windows no longer overlap. 
This means less redrawing of the screen, therefore faster response time. In addi¬ 
tion, you now have room for another frame or two. As you gain confidence in 
using Sun View, you’ll often find it handy to work with several open frames. 


Moving Icons You can’t resize icons, but you can move them just the way you move frames. 

□ Forpractice, try moving the Qock icon around with the Move accelerator. 
You may decide you’d prefer to keep it in another location. 


Zoom and FuIlScreen There are two additional menu items in the ‘Resize=>’ pull-right menu: ‘Zoom’ 

and ‘FuUScreen’. ‘Resize=>Zoom’ expands a frame vertically to the height of 
the screen. ‘Resize=^FuIlScreen’ expands a frame to the full size of the screen. 
Both of these menu items toggle to ‘UnZoom’, which restores the frame to its 
previous size and location. ‘Zoom’ and ‘UnZoom’ have the same accelerator: 

□ Hold down the I Control 1 key while you click LEFT in the frame border. The 
shorthand notation for this keyboard-mouse combination is I Control 1 -left. 
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2.5. Loading a File 


Before choosing ‘Load File’, select 
the filename. The selection can be 
in any window. 


/■ 

To try these out, resize the Console frame to full height: 

□ Choose ‘Resize=>Zoom’ from the Console’s Frame menu. 

Then change it back to its original size and location: 

o Click rCoiion -LEFT in-the Console frame’s tx)rder. The fContron -LEFT 

accelerator zooms a normal frame or, as in this case, unzooms a previously 
zoomed frame. 


Let’s load the limerick from the first lesson into the Text Editor’s edit window. 

If you don’t remember its name, you can list the directory in the Command Tool 

window. 


□ List all the files in the directory that contain the letters lim by typing the 

following command: 


r - 




venus% Is *lim* 


V 




The name of the file is lessonl. limerick. To load the file: 

□ Select its name in the Command Tool window. Reminder: The name is con¬ 
sidered two words, so you’U have to extend the selection. Move the pointer 
into the Text Editor’s edit window. f 

a Bring up the Text menu and choose Tile=^Load File’. The file is loaded, 
and the file name appears in the frame header. 

In order to leam scrolling, you need to fiU up the edit window with text. An easy 

way to do that is to put more copies of the limerick file into the window by 
choosing the ‘File=>Include File’ menu item, as shown in Figure 2-9, or by copy¬ 
ing and pasting in the window. You’ll have a chance to try both methods. 

Unlike ‘Load File’, which clears the window before it loads the file, ‘Include 
File’ inserts the specified file into the window at the insertion point (the caret), in 
addition to whatever else is in the window. 
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Figure 2-9 Loading the Limerick File 



Scratch uindow 


All Hail, tlectronic Mail! 

Gee, once I once knew a workstation fan 
Who networked, but only on LAN— 

Till he chanced to discover 
An Ethernet lovei— 

Now he's linked by e-mail to Siam, 



Save Current File 

Edit 

Store as Hew FI le 

Display 

Load File 

Find 


Extras 

Set Directory 


Empty Document 
Finishing Up | 


Add some additional copies of the limerick by following these instructions: 

□ Select the filename lessonl. limerick if it isn’t already selected. 

□ Choose ‘File=>Include File’ from the edit window’s Text menu. Another 
copy of the limerick appears. 

□ Quadruple-click the LEFT mouse button to select the entire document. 

□ Press the I Copy I function key to copy the selection onto the Qipboard. Now 
there are two limericks in the document and two on the Clipboard. 

□ Press the (Paste 1 function key to copy the Qipboard into the document. 

Now there are four copies of the limerick in the document. 
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□ Repeat the last step twice. Now there are eight copies of the limerick in the 
document. 

There’s more text in the document than you can see in the edit window. You 
could make the window taller by choosing ‘Resize=>Zoom’ from the Frame 
menu, but that wouldn’t help if you had a really large file. The SunView way to 
see all the text in a document is by scrolling. 


2.6. Scrolling The vertical bar on the left side of the edit window is called the scrollbar? Every 

text window contains a scroll bar. The Command Tool has a scrollbar also. The 
scrollbar lets you make all of a document visible by moving it through the win¬ 
dow — it’s similar to the way you wind film past the lens of a camera. The 
difference is that you can only wind the film forward, one frame at a time. Using 
the scrollbar, you can move a document backward or forward through the win¬ 
dow a line at a time or a windowful at a time. There are several additional scrol¬ 
ling techniques that let you show a specific part of the document, and there are 
scrolling accelerators. This lesson covers the basics; the advanced techniques are 
described in Chapter 7, All About Scrolling. 

Since the scratch window in the Text Editor is a text window, it has a scroUbar 
too. Because the window is only one line high, there isn’t room to show the 
entire scrollbar, so only a scroU box is displayed, as shown in Figure 2-10. The 
scroll box has the same function as the scroll boxes at either end of the edit 
window’s scroUbar. The function of the scroU boxes is described in the next sec¬ 
tion. 


Figure 2-10 Scrollbar in the Scratch Window 


textedit - (NONE), dir: /usr/nuUneg/sages 




Scratch uindoui 


Using the Scroll Boxes 



The scroU boxes at either end of the scroUbar are identical in function. They’re 
in both places for convenience, so you don’t have to move the pointer very far to 
reach one. 

The upward- and downward-facing triangles in the scroU box indicate that you 
can move the text up or down in the window. 


^ This chapter describes the scrollbar’s standard appearance. There are many interesting ways to customize 
the scroUbar. See Chapter 7, All About Scrolling, and Chapter 10, The Defaults Editor, in the Reference section 
for more information. 
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Scrolling by the Line □ Move the pointer into one of the scroll boxes in the edit window’s scroUbar. 

The pointer changes to a diamond shape, indicating that you can scroll in 
either direction. 

The LEFT mouse button scrolls lines □ Hold down the LEFT mouse button. The document scrolls upward in the 

upward The RIGHT mouse button window, and the pointer changes to an upward-facing arrow. Release the 

scrolls lines dowmvard. , ^ . ,, , , 

mouse button after you ve scrolled several hnes. 

When you hold down the mouse button in a scroll box, the document scrolls con¬ 
tinuously, a line at a time, until you release the mouse button. 

o With the pointer in the scroU box, click the RIGHT mouse button. The docu¬ 
ment scrolls downward in the window by one line, and the pointer briefly 
changes to a downward-facing arrow. 

When you click the mouse button in a scroll box, the document scrolls one line. 


Scrolling by the Windowful □ With the pointer in either scroll box, click the MIDDLE mouse button. The 

text scrolls upward by one windowful, and the pointer changes briefly to a 
right-facing triangle. 


The MIDDLE mouse button scrolls 
upward by the windowful. 

With the f Shift ! key pressed, the 
MIDDLE mouse button scrolls down¬ 
ward by the windowful. 


□ With the pointer in either scroll box, hold down the I Shift) key while click¬ 
ing the MIDDLE mouse button. The text scrolls downward by one window¬ 
ful, and the pointer changes briefly to a right-facing triangle. 

When you click the MIDDLE mouse button in a scroll box, the text scrolls one 
windowful. 

When you hold down the MIDDLE mouse button in a scroll box, the text scrolls 
continuously, a windowful at a time, until you release the mouse button. 
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The Bar and the Babble 



Scrolling Directly to a 
Location 


/ 

\ 

Besides the scroll buttons, the scrollbar contains two additional parts: 

□ The bar is the tall light-gray rectangle bounded on either end by scroll 

boxes. 

a The bubble is the dark gray part of the bar. The bubble’s size relative to the 
size of the bar tells you what percentage of the document is visible. The 
larger the document, the smaller the bubble because the less of the document 
you can see at one time. The bubble’s position in the bar teUs you the loca¬ 
tion of the text in the window relative to the whole document. When the 
bubble is at the top of the bar, the text in the window is at the beginning of 
the document; when the bubble is at the bottom of the bar, the text in the 
window is at the end of the document. 

You can’t change the bubble directly — it’s a “read-only” indicator; like the 

mercury in a thermometer, it reports on its environment. 


Sometimes you want to scroll directly to a particular location in a document. For 
example, you may remember where the bubble was when the text you want was 
showing. 

To scroll directly to a relative location in the document, move the pointer into the 
bar at the point that represents the relative location of the text in the document. 
The pointer changes to a right-facing arrow. Qick the MIDDLE mouse button. 

The text appears in the window and the bubble reflects the new location. 

□ Move the pointer into the bar just under the top scroll box. Click the MID¬ 
DLE mouse button. This is an easy method for getting to the start of a docu¬ 
ment. 

□ Move the pointer to the bottom of the bar, just above the bottom scroll box. 

Click the MIDDLE mouse button. You see the end of the document. 


NOTE Scrolling doesn’t change the location of the caret. 

Scrolling in the Command Tool window works just the way it does in the Text 
Editor. Try it out and see. 
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2.7. Displaying and Moving 

the Caret 

Occasionally when you’re scrolling, you may lose track of where the caret is. 

The ‘Display=>’ pull-right menu in the Text menu contains some handy ways to 
find or move the caret and display the line containing it in the window. 

□ ‘ Display=>Show Caret at Top’ displays the caret near the top of the window. 
This is handy if you just want to see where the caret is. Try it. 

□ ‘ Display=>Move Caret to Start’ positions the caret at the beginning of the 
document and displays the first line in the document at the top of the win¬ 
dow, Try it. 

□ ‘Display=>Move Caret to End’ positions the caret at the end of the document 
and displays the last line in the document at the bottom of the window. This 
is handy if you want to add text at the end of the document. Try it. 

Now you know a number of ways to move around in a document of any size. 

You know how to use the Text menu or the function key accelerators to paste 
text into a document. The Find and Replace frame does that, and more. It lets 
you look for a specified set of characters and replace one or some or aU 
occurrences. 

The Find and Replace frame is a panel that the Text Editor brings up when you 
choose ‘Find=>Find and Replace’ from the Text menu. A panel is another type 
of window. The panel in the Find and Replace frame contains buttons like the 
buttons in an alert window, a cycle item that lets you make choices, and text 
items where you can type and do limited editing. 

□ Bring up the Text menu and choose ‘Find=>Find and Replace’. The 
Find and Replace frame, shown in Figure 2-11, appears above the Text Edi¬ 
tor frame. 

Figure 2-11 The Find and Replace Frame 



Like other frames, the Find and Replace frame has a frame menu, but it isn’t 
quite the same as the Text Editor’s frame menu. 

□ Preview the two frame menus. Notice that the Find and Replace frame’s 
Frame menu doesn’t have ‘Quit’ at the bottom, and it has ‘Done’ instead of 
‘Qose’ at the top. 


2.8, Finding and Replacing 
Text 
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Figure 2-12 


Pushing Panel Buttons 


Replacing Text 


A text item in a panel is usually pre¬ 
ceded by a colon (:). 


Frame Menu for the Find and Replace Frame 


Find and Replace 


1 Find J 


fRep 1 ace~] ' 

[Find then Replace] [Replace then pTni 




textedit - lessonl.limerick (editedX, 


^[Scratch 


uiindou 


Done 

Move 
Resize 
Front 
lack 
Props 
Redisplay 


ID 



Because there’s no ‘Quit’ item in this frame, you can’t leave the Text Editor tool 

from here. And you can’t close the Find and Replace frame to an icon. When 

you choose ‘Done’, the Find and Replace frame disappears, but the Text Editor 
frame remains. 


In most other respects, the Find and Replace frame is like any other frame. It 
usually comes up just above its owner — the frame containing the window from 
which it was chosen — but you can resize it or move it to a new location. 

If the Find and Replace frame doesn’t appear where you expect it, you can 
easily find it. Just choose ‘Find and Replace’ again, and the Find and Replace 

frame will blink. 


A button in a panel represents an action. To choose the action, move the pointer 
onto the button and click the LEFT mouse button. This is known as pushing the 
button. It’s just like responding to an alert message, which you learned how to 
do in Chapter 1. 

□ Push the Blink Owner button in the Find and Replace frame. 

Blink Owner causes the frame that owns this Find and Replace frame to 
highlight rapidly three times. When there’s more than one Find and Replace 

frame on the screen, Blink Owner lets you find out which owner each jxip-up 

frame belongs to. 

□ In the edit window, choose ‘Find=>Find and Replace’ again. 

The Find and Replace frame blinks to let you know it’s already available. 


Let’s replace all the occurrences of workstation. 

□ Select the word workstation anywhere in the document. 

□ Choose ‘Find=>Find and Replace’. 

If text is selected when you choose ‘Find=>Find and Replace’, the selection is 
automatically pasted into the Find: text item. (You could also click LEFT in a 
text item to set the insertion point and type the text you want. Or you could put 
the text on the Clipboard and paste it into the text item in the panel.) 
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To move from one text item to the 
next in a panel, press the rReturnl 
key or the fTabTI key. 


When the Find and Eeplace frame puts the selection in the Find: text item, it 
also moves the insertion point into the Replace: text item. Just as in the edit 
window, tire insertion point — the caret — is a blinking black triangle when the 
panel has the keytx)ard focus and a gray diamond when it doesn’t. 

□ Move the pointer into the Find and Replace panel. Make sure the caret is 
in the Replace: text item. 

o Type Sun-2. The panel text items in the Find and Eeplace frame now 
look like those in Figure 2-13. 


Figure 2-13 Finding and Replacing Text 


Find and Replace 


uorkstation 
Sun-^ 


Replace] 
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[B1Ink tonerl 


After you push a panel button, the 
button turns gray while the action is 
taking place. 


□ Push the Find button (not the [ Find 1 function key). An occurrence of 
workstation is now highlighted in the edit window to indicate that it has 
been found. It looks just like a normal selection, and in fact it is. 

□ Push the Replace button to change workst at ion to Sun-2 . The selec¬ 
tion is replaced, and the caret in the edit window moves to the right of the 
replacement 

□ Move the pointer into the panel and change the Replace: text item from 
Sun-2 to Sun-3 . The caret is positioned after Sun-2 because that was 
the last text you typed in the panel. 

□ Press the f Delete ] key once to erase the 2 , then type 3. Now the Replace: 
text item contains Sun-3 . 

□ Push the Find button again. The next occurrence of workstation is 
selected. 


□ Push the Replace then Find button. The selection changes from works¬ 
tation to Sun-3 and yet another occurrence of workstation is found. 

□ Move the pointer into the panel and change Sun-3 to Sun-4 by erasing 
the 3 and typing 4. 

□ Push the Replace All button. The remaining occurrences of worksta¬ 
tion are replaced by Sun-4. 

□ Push the Find button. 


Since workstation no longer exists in the edit window, the window blinks 
and beeps to tell you the Find: text item wasn’t found. 


□ Scroll through the document in the edit window to see the changes you 
made. 
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Menus in Panels Panel items often have menus associated with them. 

Cycle items, like the All Text/To End item in the Find and Replace panel, 
always have menus. The current choice is checked in the menu and appears to 
the right of the cycle item. 

□ To End means search from the caret to the end of the document. 

□ All Text (the default) means search firom the caret to the end of the docu¬ 
ment, then from the beginning of the document back to the caret. 

Figure 2-14 A Cycle Item’s Menu 



Menus in panels work just like 
menus in other windows. 


To preview a menu in a panel, move the pointer to the item and hold down the 
RIGHT mouse button. To dismiss the menu without choosing an item, move the 
pointer off the menu so that no menu item is highlighted (moving the pointer 
leftward usually works best), and release the mouse button. 

□ There’s a second menu in the Find and Replace panel. Can you find it? 
Move the pointer onto each button and other item in the panel, and preview 
to see if there’s a menu behind it. 

The Find button contains a menu that lets you specify ‘Forward’ or ‘Backward’ 
as the direction of the search. ‘Forward’ is the default. 

Other tools with panels include the Mail Tool and the Defaults Editor. When 
you start to use them, check for menus so you won’t miss out on some nifty 
features. 

o You’ve finished the part of the lesson that uses the Find and Replace frame, 
so click LEFT on the Done button to put the frame away. 


2,9. Wrapping Long Lines Thelimerickyou’vebeenworking with has very short lines. If you wiU be woik- 
of Text ing with documents that contain text in paragraph form, or that contain long 

lines, you’ll want to know about the ‘Display=^Change Line Wrap=>’ puU-right 
menu in the Text menu. 

First let’s get some long lines into the document by replacing all the Return char¬ 
acters with spaces. Since the (Return 1 key has a special fiinction — moving the 
caret between the Find: and Replace: text items — there’s no way to search for 
the Return character using the Find and Replace frame, but you can use other 
Find features to do this search. 
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□ Click LEFT after the last character in the first line of the limerick to select the 
Return character. 

□ Choose ‘Find=»Find Selection=>’ to find the Return character in the next 
line. 

□ Press the I Cut I fiinction key, then type a space. Cutting puts the Return 
character on the Qipboard. 

Now that you’ve replaced the first Return character with a space, you can easily 

repeat the sequence of actions. 

□ Press the I Again I function key. (Or choose ‘Edit=>Again’ from the Text 
menu.) 

Each time you press ( Again 1 . the next replacement occurs. 1 Again I lets you 

repeat a series of edit operations. 

a Press [ Again 1 repeatedly until the window blinks and beeps. That’s the sig¬ 
nal that ‘Find’ can’t find any more Return characters. 
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\ 

‘Wrap at Character’ Now the document is a single long line. You can type normal text — letters and 

memos — this way, without inserting Return characters except at the end of a 
paragraph. The Text Editor displays text on a new line in the window when the 
current line is about to overflow. 

□ Try getting rid of the Tab characters the same way you got rid of the Return 
characters, using [ Find ] . fCutl and f Agaml . (When there’s a selection — in 
this case, when you select a Tab character — pressing the i Find") function 
key is the equivalent of choosing ‘Find=^>Find Selection=>Forward’.) The 
edit window should then look like the one in Figure 2-15. 

Figure 2-15 A Document with Character Wrap 


The I Find 1 function key is an 
accelerator for 
‘Find=»Find Selection=>’. 


If I Scratch uiindow 

B ah Hail, Electronic Mail! Gee, once I once kneu a Sun-4 fan Who netuorked, but 
only on LAN— Till he chanced to discover An Ethernet lovei— Nau he's linked 
V by e-mail to Siam, All Hail, Electronic Mail I Gee, once I once knew a Sun-2 fa 
n Who networked, but only on LAN— Till he chanced to discover An Ethernet lov 
ei— Now he's linked by e-mail to Siam. All Hail, Electronic Mail^! Gee, once I 

I once knew a Sun-3 fan Who networked, but only on LAN— Till he chanced to disco 
ver An Ethernet lover— New he's linked by e-mail to Siam. All Hail, Electronic 
Mail! Gee, once I once knew a Sun-4 fan Who networked, but only on LAN— Till 
he chanced to discover An Ethernet lover— Now he's linked by e-mail to Siam. 
All Hail, Electronic Mail I Gee, once I once knew a Sun-4 fan Who networked, but 
only on LAN— Till he chanced to discover An Ethernet lovei— New he's linked 
by e-mail to Siam. All Hail, Electronic Mail! Gee, once I once knew a Sun-4 fa 
n Who networked, but only on LAN— Till he chanced to discover An Ethernet lov 
er— Noj he's linked by e-mail to Siam. All Hail, Electronic Mail! Gee, once I 
once knew a Sun-4 fan Who networked, but only on LAN— Till he chanced to disco 
ver An Ethernet lovei— Noii he's linked by e-mail to Siam. All Hail, Electronic 
Mail! Gee, once I once knew a Sun-4 fan Who networked, but only on LAN— Till 
he chanced to discover An Ethernet lovei— Noj he's linked by e-mail to Siam. 




‘Wrap at Word’ 
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The text in the document wraps at the right edge of the window. If a word 
doesn’t fit on a line, it wraps the remaining characters around to the next line. 
That’s kind of hard to read because words at the end of the line may be broken in 
strange places, so let’s change the way the line wraps: 

o Choose ‘Display=^Change Line Wrap=>Wrap at Word’. The window 
changes to look like Figure 2-16. Notice that words are no longer split 
between lines. If a word is too long to fit at the end of a line, it is moved to 
the beginning of the next line. 


Figure 2-16 A Document with Word Wrap 


textedit r lessbnl.limerick (edited), dir: /usr/nutraeg/sages 


Scratch uindoui 


All Hail, Electronic Mai 1! Gee, once I once kneuj a Sun-4 fan Who networked, but 
only on LAN— Till he chanced to discover An Ethernet lovei— Now he's linked 
by e-mail to Siam. All Hail, Electronic Mail! Gee, once I once knew a Sun-2 fan 
Who networked, but only on LAN— Till he chanced to discover An Ethernet 

lovei— Now he's linked by e-mail to Siam. All Hail, Electronic? Mai 1 I Gee, once 

I once knew a Sun-3 fan Who networked, but only on LAN— Till he chanced to 
discover An Ethernet lovei— Now he's linked by e-mail to Siam. All Hail, 
Electronic Mail! Gee, once I once knew a Sun-4 fan Who networked, but only on 

LAN— Till he chanced to discover An Ethernet lovei— Now he's linked by 

e-mail to Siam. All Hail, Electronic Mail! Gee, once I once knew a Sun-4 fan 
Who networked, but only on LAN— Till he chanced to discover An Ethernet 

lovei— Now he's linked by e-mail to Siam. All Hail, Electronic Mail! Gee, once 

I once knaj a Sun-4 fan Who networked, but only on LAN— Till he chanced to 
discover An Ethernet lovei— Now he’s linked by e-mail to Siam. All Hail, 
Electronic Mail! Gee, once I once knew a Sun-4 fan Who networked, but only on 

LAN— Till he chanced to discover An Ethernet lovei— Now he's linked by 

e-mail to Siam. All Hail, Electronic Mail! Gee, once I once knew a Sun-4 fan 
I Who networked, but only on LAN— Till he chanced to discover An Ethernet 
lovei— Now he's linked by e-mail to Siam. 


The actual text hasn’t changed. Only its appearance on the screen is different. 

NOTE In Mail Tool and certain other tools, and in some SunOS commands such as 
Ipr, ‘Wrap at Word’ looks great in the window but may give unsatisfactory 
results if you print the contents. For better printed output, control the line length 
yourself by pressing the I Return 1 key at the end of each line, as you did when typ¬ 
ing the limerick. 
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‘Clip Lines’ 


Instead of wrapping text, you can clip it so that whatever doesn’t fit on a line of 
the screen doesn’t show. It appears to be truncated on the right. Clipping 
doesn’t actually snip off the part of the text that isn’t shown — it just hides it. 

o Choose ‘Display=:>Change Line Wrap==>Qip Lines’. Only the first few 
words of the document appear in the window. 


Figure 2-17 A Document with Clipped Lines 


textedit - lessonl.nmerick (edited), dir: /usr/nutnieg/sages 



Remember that we took out all the Return characters, so the Text Editor regards 
the document as one long line. It has clipped off the part that couldn’t be 
displayed. If you widen the frame with ‘Resize=»’, you’ll see more of the line. 
Or you can change the line wrap back to the way it was: 

□ Choose ‘Wrap at Character’ from the ‘Display=^^Change Line Wrap==>’ 
pull-right menu to go back to the default setting. 

It’s time to end this lesson. If you’d like to save the document in its present 
form, you can either choose ‘File=>Save Current File’ or type a new name in the 
scratch window, select it, and choose ‘File=^>Store as New File’. 

□ Preview the ‘File=:>Fini siting Up=>’ puU-right menu to see some other 
interesting ways to save a file. 


A 
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2.10. Exiting SunView The normal way of ending a work session is to lock the screen. You don’t have 

to go back to the SunOS shell, since you can execute commands from a Com¬ 
mand Tool. Occasionally, though, you may want to restart SunView in order to 
change the startup options. 

To exit and restart SunView: 

□ Move the pointer over the gray background. 

□ Bring up the SunView menu and choose ‘Exit SunView’. 

o FoUow the instructions for starting SunView at the beginning of Chapter 1, 
Getting Started with SunView. 


2.11. A Word to the Wise You now know all of the SunView basics plus some fancy twists. But there’s a 

lot you can do to make your SunView environment more efficient and personally 
pleasing. You’U miss out on many attractive features unless you read the Refer¬ 
ence section, especially the chapter on The Defaults Editor. 

To whet your appetite, here are some features you might like to try: 

□ Stay-up menus let you preview menus without having to keep holding down 
the mouse button. You click to bring the menu up and click again to choose 
a menu item or take the menu down. 

□ Pending-delete is a way of selecting text so that you can replace it without 
having to delete it first. This feature makes the Text Editor work more like a 
personal computer’s word processor. 

□ Icons can be displayed in the SunView menu instead of toolnames. The 
‘Qock=>’ puU-right menu in the SunView menu shows you how this looks. 

□ If you’re left-handed, you can rearrange the standard function keys and add 
special functions of your own. 

□ ‘Split View’ in the Text menu lets you divide a window into two or more 
sections and scroll them individually. 

□ Reduced mousing is possible by using keyboard accelerators instead of the 
mouse to move the caret around. 

□ Find Marked Text is a pop-up frame that you bring up from the ‘Find=>’ 
pull-right menu. It finds text that’s enclosed in certain standard delimiters, 
like parentheses and quotation marks. 

o The ‘Extras=>’ pull-right menu contains lots of formatting shortcuts for 
source programs and other text. 

If nothing on this list caught your attention, you probably have everything you 
need to be happy in SunView right now. Go to! 

If you saw something you’d like to try, read on. And happy exploring. 
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Starting and Exiting Sun View 


3.1. Starting Sun View To start SunView from a SunOS command line, type sunview in response to 

the command prompt: 


r 




venus% sunview 


L... 


J 


The directory you’re in when you start SunView is the directory that SunView 
tools come up in. This manual shows SunView starting from your home direc¬ 
tory, but you can start SunView in any directory. For more details, follow the 
instructions in Chapter 1, Getting Started with SunView. These instructions tell 
you how to bring up SunView with the standard options. 

There are various ways to modify the SunView display, as described under the 
sunview command in the SunOS Reference Manual Two of the more interest¬ 
ing options are shown below. 


Customizing the Background 
Pattern 


The SunView background doesn’t have to be plain gray. Using the 
-background option, you can display a picture on the screen to serve as the 
background. 

□ To display a background picture, type the following command line: 


f ^ — -^ ^ ■■ -———^—:-— ——- 

venus% sunview -background filename 

.. ^ 

1 

j 


The filename file contains the picture you want to use as a background. This file 
is a standard rasterfile , a graphics file that you can produce using screen- 
dump , the Icon Editor, or other image-producing software.^ 

For example, suppose you have a file called Celtics that contains the back¬ 
ground pattern shown in Figure 3-1. 


^ For more information about screendump, see the screendump ctanmand in the SunOS Reference 
Manual. 
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□ To Start SunView with the Celtics file as the background, type the fol¬ 
lowing command: 


Figure 3-1 A Cheering Background 






*-»ir • * *-»«v 

_Es5 v:;r* 






lellicst 
/eniis*i I 


rasterfile, 1152x908x1 standard format Iwage 




text and frame borders in white — rather than the default of white windows and 


black text on a light gray background. Some people think inverse video is easier 
on the eyes. 
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□ To display the custom background screen in inverse video, add the -i (for 
inverse ) option when you start SunView: 

venus% sunview ~i -background Celtics 

. ___ / 

Here’s what inverse video looks like: 

Figure 3-2 The Customized Screen in Inverse Video 



You don’t have to have a special background to use inverse video. You can use 
the -i option all by itself to get the standard SunView screen in inverse video. 


3.2. Saving the Layout If you like the way you’ve set up your screen and don’t want to go to the trouble 

of starting tools and moving and resizing frames every time you start SunView, 
you can have SunView recreate your personal environment automatically. 

The ‘Save Layout’ menu item in the SunView menu saves a map of the screen in 
the . sunview file in your home directory. (If the file already exists, its con¬ 
tents are replaced.) The next time you start SunView, the information in the 
. sunview file is used to recreate your environment just the way you like it. Or 
you can save several layouts and specify the one you want — see Section 5.7 for 
details. 
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3.3. Locking the Screen Locking the screen displays a changing pattern that protects the privacy of your 

open windows and also prevents the image from burning into the screen when 
you leave your workstation unattended for a long f«riod of time. 

□ To lock the screen, choose ‘Services=>Lock Screen’ from the SunView 

menu. 

□ To unlock the screen, click any mouse button or press any keyboard key 

except [ FI ] or I Cans i . then type your password and press [ Return) . 

For more information on locking and unlocking the screen, see the information 
on *Lock Screen’ in the Lessons section and in Chapter 8, All About Menus. 

3.4. Exiting SunView When you quit SunView, the contents of all windows are forgotten unless you 

save them. (By contrast, when you close a frame, the contents of its windows are 
remembered and restored when you open its icon.) The screen layout (current 
icon and frame locations) is also forgotten unless you saved it by choosing 

‘Services=»Save Layout’ from the SunView menu. 

□ To quit the SunView windows environment and return to the SunOS com¬ 
mand line, choose ‘Exit SunView’ from the SunView menu. 

Emergency Exit Sometimes you want to leave SunView under catastrophic conditions, and you 

can’t access the SunView menu. 

To exit SunView in an emergency: 

□ Move the pointer over the gray background. This emergency technique 
works only if the pointer is not over a frame or icon. 

□ Type rControl-D 1 followed by f Control-01 to bail out from the keyboard. 

NOTE This is not the recommended way to exit SunView. Use the SunView menu if you 

can. 
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All About Keyboards 


This chapter teUs you: 

□ How to tell which model keyboard you have. 

□ How to label the function keys using the stickers provided with your Sun 
documentation. 

□ How to notify the Defaults Editor that you’re a left-handed user of the key¬ 
board and mouse. 

□ How to change your keyboard focus to Qick-to-Type. 

□ How to “map” (customize) the unused function keys. 

The use of the keyboard for menu and mouse shortcuts is described in Chapter 9, 
All About Accelerators. 

4.1, Which Sun Keyboard Diagrams of the Typed, Type3, and Type2 keyboards are provided on the follow- 
Do You Have? ing pages. Compare the diagrams to your keyboard to determine which type you 

have. 

This manual assumes you have a Typed keyboard. If you have another type, use 
the labels provided with your documentation to label your keyboard so that it 
looks like a Typed keyboard. (See Section d.2 for details.) Then you’ll be able 
to follow the keyboard references in this manual. 

If you’re a left-handed keyboard and mouse user, you’ll need labels even if you 
have a Typed keytoard. 
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v... 

Figure 4-1 The Type4 Keyboard 
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Figure 4-2 The Typed Keyboard 
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V../ 

Figure 4-3 The Type2 Keyboard 
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4.2. How to Label the This section applies only to Type2 and TypeS keyboard users and to left-handed 

Keyboard Type4 keyboard users. The Type4 keyboard is already labeled correctly for 

right-handed users. 

NOTE Your workstation model number may dijferfrom your keyboard model. For 

example, it’s possible to use a Type2 keyboard with a workstation, and 

vice versa. 

Other keyboards must be labeled with the stickers that come with your Sun docu¬ 
mentation. The labels make your keyboard look like a Type4 keyboard so that 
you can follow the instructions in this manual and related manuals. 

Here’s how to label your keyboard (if you’re left-handed, read Section 4.3 on 
Left-Handed Keyboard Use before following these instructions): 

o Compare your keyboard with Figures 4-1 through 4-3 to find out what kind 

of keyboard you have. 

□ Follow the labeling diagram that corresponds to your keyboard type — see 
Figures 4-4 through 4-6. 

□ Move the pointer over the gray background as you affix the labels to the 
keys so you won’t accidentally cause a function key operation to be per¬ 
formed. 

□ Affix the appropriately sized and marked labels provided with your Sun 
documentation. 

You can remove and restick the labels, if necessary, without damaging the labels 
or the keyboard. 


4.3. Left-Handed The Defaults Editor, described in Chapter 10, lets you specify which side of the 

Keyboard Use keyboard you want the function keys on. 

If you like moving the mouse with your right hand, you don’t have to change 
anything. Right-handed people use the keys located on the left of the keyboard 
as their function keys. 

However, left-handed people sometimes prefer having function keys on the right 
side of the keyboard and moving the mouse on the left. They use keys in the 
right-hand keypad, (Rl 1 through IR151 . as their function keys. 

When you set up your system for left-handed use, the LEFT and RIGHT mouse but¬ 
tons switch so that the mouse button you click with your index finger is always 
LEFT whether you’re right-handed or left-handed. 

To set up the keyboard and mouse for left-handed use: 

□ Latel the keyboard, as described above. Put the function key stickers on the 
right side of the keyboard. 

□ Notify the Defaults Editor that you’re using left-handed mousing and func¬ 
tion keys on the right by setting the default value for the Lef t_Handed 
default line in the Input category to Yes. 
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The Type4 function keys on the left have names printed on them. If you’re 
right-handed, that’s all you need. 

If you plan to use a left-handed setup, label the keys as shown on the right side of 
the diagram. 
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The Types keyboard has a pre-labeled 




The “diamond” (♦) labels are for the Meta keys — the keys on either side of the 
space bar. On the TypeS keyboard, these keys are marked Left and Right. 
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Figure 4-6 How to Label the Type! Keyboard 
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The even-numbered function keys between (Ll 1 and fLlO) on the left side of the 
Type2 keyboard are narrower than the odd-numbered function keys, so use the 
narrow labels for those keys. 

The “diamond” (♦) labels are for the Meta keys — the keys on either side of the 
space bar. On the Type2 keyboard, these keys are marked LEFT and RIGHT. 

The Type2 keyboard has no built-in (Cans 1 key. Put the I Cans I label on the fFTI 
key. 
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4.4. Click-to-Type 

Keyboard Focus 


Why Use Click-to-Type? 


The window that receives whatever you type is said to have the keyboard focus. 
Here’s how you can tell which window has the keytx)ard focus: 

□ The window border thickens. When a window receives the keyboard focus, 
its border changes to a bold black line. When the keyboard focus is not in 
the window, its border is a thin line. 

□ The caret blinks.^ The caret represents the insertion point — the place in the 
text window that receives the next character you type or paste. When the 
keyboard focus is in a window, its caret is a small black blinking triangle 
just below the line of type. When the keyboard focus is not in a window, its 
caret appears as an unblinking gray diamond. 

Normally you set the keyboard focus — choose the window you want to type in 
— by moving the pointer into the window. This is called Pointer-in-Window or 
Mouse-to-Type keyboard focus, and it’s the default in SunView. 

Click-to-Type is an alternative method of setting the keyboard focus. With 
Click-to-Type, you click the LEFT or MIDDLE mouse button inside the window 
you want to have the keyboard focus, without pressing any function key. Then, 
no matter where you move the pointer, the keyboard focus stays in the window 
you clicked in. In fact, you can even type into a frame that’s been closed to an 
icon when you have Click-to-Type. 


When copying text from one window to another with Pointer-in-Window key¬ 
board focus, you must be careful to press the (Paste 1 key with the pointer in the 
destination window before moving the pointer to the source window to select the 
text to copy. Then you have to remember to move the pointer back to the desti¬ 
nation window before continuing to type. 

Similarly, when using Dbx Tool, you can’t move the pointer into the source win¬ 
dow to select a breakpoint location and immediately type a command — you 
have to return the pointer to the command window first. 

Instead, you can use Qick-to-Type keyboard focus. Qick-to-Type allows key¬ 
board input and mouse input to have different destinations. 

When you use Click-to-Type, the destination for keyboard input isn’t changed 
until you click with the {X)inter in another window: 

□ You click LEFT in a new window to change the keyboard focus, set the caret, 

and make a selection. 

o You click MIDDLE in a new window to change the keyboard focus while 

retaining the current selection. 

With Qick-to-Type, for example, you can move the pointer outside the text win¬ 
dow where you’re typing in order to push buttons in a control panel or make a 
secondary selection in another window. Then you can continue typing without 
having to move the pointer back into the text window. 


^ You can fine-tune performance by turning off the Text /Blink caret option in the Defaults Editor. If 
you do, the caret will be a black unblinking triangle. 
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How to Get Click-to-Type 


4.5. Mapping Functions to 
Keys 


Tty Windows and the 
. ttyswrc File 


You can permanently change the type of keyboard focus through the Defaults 

Editor: 

□ To change keyboard focus to Qick-to-Type, set the Click-to-Type 
default value in the SunView category to Enabled. 

□ To change back to Pointer-in-Window, set the Click-to-Type default 
value back to Disabled, the SunView default. 

If you want to change the type of keyboard focus temporarily to see which kind 
you like best, run swin in a Command Tool. The swin command changes the 
type of keyboard focus for all windows immediately. 

□ To set Click-to-Type keyboard focus, type: 


venus% swin -c 

'' ■ _ ^ 


□ To go back to Pointer-in-Window (Mouse-to-Type) keyboard focus, tyj^: 


-- 

venus% swin -m 

V_ ... / :V ■ ■ ^ ■ _/ 


You can change the way text windows and tty windows respond to some of the 
function keys and other nonalphanumeric keys by associating them with func¬ 
tions or text filters. This is known as mapping or binding filters to keys. 

Text windows are remapped through a . textswrc file. Tty windows are 
remapped through a .ttyswrc file. In order to cause remapping, the files must 
be in your home directory. 

Which keys can be remapped depends on whether you’re operating SunView in 
the nonnal right-handed mode or have set Input/Left_Handed to Yes in 
the Defaults Editor. 


With a . ttyswrc file in your home directory, you can assign alternate func¬ 
tions to keys and change the default page mode of your tty windows. 

Table 4-1 shows the keys that are not available to be remapped. 
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Table 4-1 Keys Not Available for Remapping in . ttyswrc 


Right-Handed Keyboard 

Left-Handed Keyboard 

L1-L10,F1 

LI, FI 


R1,R4, R7,R10,R13, 


R3, R6, R9, R12, R15. 

With arrow keys enabled: 

With arrow keys enabled: 

R8,R10,R12,R14. 

R2, R5,R8,R14 


If your file tries to remap a key that can’t be remapped, you’ll see an error mes¬ 
sage like this: 

.ttyswrc error: keyname cannot be mapped. 

This message means that the . ttyswrc file contains function key specifications 
that conflict with the standard SunView function key assignments. Be careful 
about trying to assign new functions to the function keys used by text windows 
or to the arrow keys. When you start a SunView tool, SunView takes control of 
your function keys, disallowing any other functions you may have assigned to 
those keys. 


Enabling Page Mode Page mode refers to the mechanism in a tty window that lets you look at one 

windowful at a time. It’s described under the ‘Enable Page Mode’ menu item in 
the Tty menu, in Chapter 8, All About Menus. 

By default, page mode is disabled in tty windows until you choose ‘Enable Page 
Mode’. However, you can set the default to “enabled” by including the follow¬ 
ing line in your . ttyswrc file. 

set pagemode 



Format of the . ttyswrc File The format of the . ttyswrc file is: 

# Starts comments line, 

set pagemode Enables page mode, 

mapi key text Inputs text when key is pressed, 

mapo key text Outputs text when key is pressed. 

Key can be any function key not shown in Table 4-1. Text may contain escape 
strings, such as \E for escape, \n for newline, and "X for I Control-X I . 
See termcap in the SunOS Reference Manual for the format of escape strings 
recognized by tty windows. 

A tty-based program can send special escape sequences, shown in Figure 4-7, to 
perform certain operations. These escape sequences may also be sent using the 
mapo function shown above. The escape sequences are received by the tool that 
owns the tty window, not by the command shell that’s running in the tty window. 
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Figure 4-7 Tty Escape Sequences 


- - 

\E[lt 

- open 

\E[2t 

- close (become iconic) 

\E[3t 

- move, with interactive feedback 

\E[3;TOP;LEFTt 

- move, to TOP LEFT (pixel coordinates) 

\E [4t 

- stretch, with interactive feedback 

\E[4;WIDTH;HTt 

- stretch, to width ht size (in pixels) 

\E[5t 

- front (expose) 

\E[6t 

- back (hide) 

\E[7t 

- refresh 

\E [ 8; ROWS; COLSt- Stretch, to ROWS COLS size (in characters) 

\E[llt 

- report if open or iconic by sending \E[ltor\E[2t 

\E[13t 

- report position by sending \E [ 3 / TOP; LEFTt 

\E[14t 

- report size in pixels by sending \E [ 4; WIDTH; HTt 

\E [18t 

- report size in characters by sending \E [ 8; ROWS; COLSt 

\E[20t 

- report icon label by sending \E] Llabel\E\ 

\E[21t 

- report frame header by sending \E] llabel\E\ 

\E] l<text>\^\ 

- set frame header to <text> 

\E] I<yi/e>\E\ 

- set icon to the icon contained in <file>', 

<file> must be in iconedit output format 

\E] -L<label>\E\ 

- set icon label to <label> 

\E[>OPT;...h 

- turn OPT on (OPT = 1 => pagemode), e.g., \E [>1; 3; 4h 

\E[>OPT;...k 

-report OPT; sends \E [>opt 1 or \E [>OPTh for each opt 

\E[>OPT;...1 

- turn OPT off (OPT = 1 => pagemode), e.g., \E [>l; 3; 41 

V _ 

> 


The following aliases use escape sequences. You can type them from the key¬ 
board, or you can put them into your ~ / . c shr c file: 

# dynamically set the frame header of the tool: 

alias header 'echo -n 1\! 

# dynamically set the label on the icon: 
alias iheader 'echo -n ""[]L\!*"[\"' 

# dynamically set the image on the icon: 
alias icon 'echo -n "" [ ]I\!*" [\"' 

For example, the header alias lets you put the current working directory into 
the frame header by typing: 


-- ; - ^ --- 

venus% header 'pwd' 

' _ _> 
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Sample . ttyswrc File 


Figure 4-8 contains an example of a 

home directory and modify. 


ttyswrc file that you can copy into your 


Figure 4-8 Example of a .ttyswrc File 


venus% cat .ttyswrc 
# 

# 

# 

set 

# Move: 

mapo T3 

# Stretch: 

mapo T4 

# Refresh: 

mapo T5 E[7t 

# Move (non-interactive) to top left: 

mapo T6 E[3;l;lt 

# Stretch in chars (non-interactive) to half high: 

mapo T7 E[8;10/80t 

# Stretch in chars (non-interactive) to normal size: 


ttywindow startup file 
pagemode 

E[3t 
E[4t 


mapo 
# Mail 


T8 


mapi 

mapi 

mapi 


R1 

R2 

R3 


E[8;34;80t 


dt 


s +planning\ndt\n 
s +bugs\ndt\n. sp 

# Editing: 

# Bracket word in italic escapes while in vi: 

mapi R4 iEeaE 

# Bracket word in bold escapes while in vi: 

mapi R5 iEeaE 

venus% 


Text Windows and the Whenever you bring up a text window, SunView looks for a . text swrc file in 

. t ext s wr c File your home directory. This file lets you bind filters to unused function keys — by 

pressing the function key named in the file, you pipe, the primary selection to a 
text filter as stdin. The resulting output (stdout) is inserted at the caret. If 
the selection is pending-delete, the output from the filter will replace it. 

A simpler alternative is to add filtere to the ‘Extras=>’ pull-right menu by modi¬ 
fying the . text_extras_menu file, as described in Chapter 8, All About 
Menus. 
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Format of the 
File 


. textswrc List the sample file, /usr/lib/ . text swrc, to see an example of filters used 

with a right-handed keyboard. 

You can copy the sample file into your home directory and modify it. 

Here is the basic format of each . text swrc file entry: 

key-name FILTER 

command-line 

For example, 

KEY_RIGHT(5) FILTER 
insert_brackets \( \) 

causes a pending-delete selection to be enclosed in parentheses by the 
insert_brackets command when fRSl is pressed. 

The filter you specify must appear in a directory accessible by your search path. 
If the command is not found, or if there is some other failure in the invocation of 
the filter, no change occurs in the document. 

The keys listed in Table 4-2 may not be remapped. 


Table 4-2 Keys Not Available for Remapping in .textswrc 


Right-Handed Keyboard 

Left-Handed Keyboard 

L1-L10,F1 

LI, FI 

R1,R4, R7, R10,R13, 

R3, R6, R9, R12, R15. 

With arrow keys enabled: 

With arrow keys enabled: 

R8,R10,R12,R14. 

R2, R5, R8, R14. 

With new accelerators enabled: 
R7,R11,R13. 



To change arrow keys and new accelerators defaults, use the 

CompatibilitY/New___keyboard_accelerators and 
Input/Arrow^Keys Options in the Defaults Editor. 

CAUTION Do not remap the arrow keys without setting Input/Arrow_Keys to No. 
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All About Frames and Windows. 

5.1. Anatomy of a Frame. 

The Frame Header ....... 

Pop-Up Frames. 

5.2. Text Windows ..... 

Scratch Windows.... 

Changing the Scratch Window Size 
Changing Direction with the Shift Key 

Mousing Ahead... 

Filtering Selections .... 

5.3. Command Windows. 

The Command Line..... 

Changing Command Modes. 
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All About Frames and Windows 


5.1. Anatomy of a Frame Every tool that runs in SunView has one or more frames. An open frame con¬ 
tains at least one window. A closed frame appears as an icon. Figure 5-1 shows 
a Command Tool frame open and another Command Tool frame closed to an 
icon. The Find and Replace frame is a pop-up frame belonging in this case to 
the open Command Tool frame. (You can bring up a Find and Replace frame 
from any text window or command window.) 


Figure 5-1 The Parts of a Frame 












J-TTnd J : find___text 

^|^Done|^| 

(^placej : replace_tex-^ 

CaII Text! 

[Find then Replace] [Replace then Find] [Replace All] 

[Blink Owner] | 

1-If 


Do you want to enter a caption : 

(a) in the CP macro ? 

(b) with the FN macro ? 

(c) no caption 7 

a, b, or c ; b 

Do you want to specify size by Height, Witj 
H, W, or S ; w 

What is Width of illustration ? 

Width (inches) - 5 


Close 
Move =4 
Resize =» 

Front 
Back 
Projis 
Redisplay 
Quit 


Point anywhere in the frame border, 
then hold down the right mouse 
button to bring up the Frame menu. 



The perimeter of the frame, known as the frame border, is where you bring up 
the Frame menu. 

Frames contain windows, where you edit text, type commands, push buttons, 
draw pictures, or do whatever the application that owns the frame lets you do. 
There are five types of windows: 

o Text windows — for displaying and editing text. 
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The Frame Header 


Pop-Up Frames 


5.2. Text Windows 


□ Panels — for controlling applications. 

□ Command windows — for running SunOS commands. 

□ Tty windows — for emulating a tty dialog. 

□ Canvases — for displaying images. 

The types of windows are described later in this chapter. 

When the pointer is in a window, the window can receive input from the key¬ 
board and is said to have the keyboard focus. The window that has the keyboard 
focus has its border thickened to a bold black line. 

The wide black stripe at the top of the frame is called the frame header. 

The left side of the frame header contains the name of the tool that “owns” the 
frame. The rest of the frame header contains valuable information about the 
frame. For example, the Text Editor frame header teUs you: 

□ The name of the current file — or (NONE). 

□ Whether the current file has been edited since it was last saved. 

o The default directory — the directory that is searched to store, load, or 
include a file with a relative pathname. 

As soon as you edit in the Text Editor’s edit window, (edited) appears in the 
frame header. If the Text Editor frame is closed, a greater-than symbol (>) 
appears in front of the filename on the icon if you’ve done some editing you 
haven’t yet saved. 

Pop-up frames are usually used for temporary tasks like finding and replacing 
text. Pop-up frames have ‘Done’ instead of ‘Quit’ in the Frame menu. If its 
Frame menu contains ‘Done’, the pop-up frame is actually a subframe. Unlike a 
regular frame, a subframe can’t be closed to an icon. The Find and Replace 
pop-up frame is actually a subframe, but the Reply to or Compose Mail pop-up 
frame is a regular frame that you can close to an icon. 

Text windows let you display and edit text.^ 

Many applications are built on text window capabilities, such as Text Editor for 
files. Command Tool for command interpretation. Mail Tool for mail operations, 
and Dbx Tool for debugging. 

The text window is where you bring up the Text menu, which provides opera¬ 
tions for loading and saving files, editing, changing how text is displayed, and 
finding and replacing text. 


® Documentation on the programming interface for text windows is found in the SunView 1 Programmer s 
Guide. 
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CAUTION Nothing prevents you from editing a file In more than one window at the 

same time, but this is not a good idea! If you change the file in one window 
and then go on editing in another window, you will destroy the integrity of 
the file. This is true whether you change the file using Text Editor, vi, or by 
any other means in text windows, command windows, or tty windows. 


Scratch Windows Some applications contain a special kind of text window called the scratch win¬ 

dow, which provides a work area for the application. The scratch window has all 
the editing capabilities of a regular text window, since it has its own Text menu, 
but some of the file capabilities are disabled. 

You can’t choose ‘Load File’ in a scratch window, and you can’t choose ‘Set 
Directory’. These features, which update the frame header, are reserved for regu¬ 
lar text windows. 

You can choose ‘Store to Named File’ to save the contents of the scratch win¬ 
dow. When you want to retrieve them, choose ‘Include File’ from the ‘File=>’ 
pull-right menu in the Text menu. 

Another limitation of the scratch window is that it doesn’t change the frame 
header when you save or include a file. This is actually an advantage, since you 
probably are much more concerned about the state of the document you’re edit¬ 
ing than about the electronic scratch pad. 

You can specify the number of lines in the Text Editor’s scratch window by 
using the Defaults Editor. The default is one line. 

You can also increase the number of lines in the scratch window with the Resize 
accelerator: 

□ Move the pointer to the bottom edge of the scratch window. The pointer 
changes to a target. 

□ Hold down the (Control I key. 

□ Hold down the MIDDLE mouse button and drag the scratch window down¬ 
ward. 

□ When the scratch window is big enough, release the mouse button and the 
(Control I key. 

The I Shift I key often lets you reverse an action or apply the action in the opposite 
direction. For example: I Shift-Findl means search in the Backward direction. 

I Shift 1 in scrolling means scroll with respect to the bottom of the window, rather 
than the top. I Shift-Delete 1 . 1 Shift-Control-W I . and I 8hift-Control-U I erase the next 
(not previous) character, word, or line. 


Changing Direction with the 
Shift Key 


Changing the Scratch Window 
Size 
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Mousing Ahead 


Filtering Selections 


5.3. Command Windows 

The Command Line 


You don’t have to wait for an operation to completed before you start the next 
one; you can mouse ahead. As you become more adept at woridng in SunView, 
you will probably start to mouse ahead more and more. 

However, you may not get the results you expect when you mouse ahead, since 
the text window doesn’t immediately figure out the location where you click — it 
finishes processing the first operation first. By the time it processes the click, the 
display may have changed, causing a different selection from the one you 
thought you made when you moused ahead. 

You can cut a word in one line, then mouse ahead and cut a word in the next line 
before the display has been updated to reflect the first cut. It doesn’t matter when 
the display of the first line is updated — there won’t be any effect on the next 
line. 

If you mouse ahead and make a cut later in the same line, the first cut causes the 
rest of the line to move left and your second selection may be misinterpreted. 

To mouse ahead safely in a text window, do the operations bottom to top and 
right to left. Then you can be sure of the results. 


A filter is a command that transforms text. For example, indent and capi¬ 
tal! ze are text filters. There are three ways to filter text in SunView: 

□ You can add a text-filtering command to the ‘Extras=>’ puU-right menu, 
which already contains a standard set of text filters. See Chapter 8, All 
About Menus, for information on how to add filters to the ‘Extras=»’ pull- 
right menu. 

□ You can use the get_select ion command on a command line to pass 
the selection to a text filter such as a spelling checker. get_selection 
sends the selection to a filter and inserts the resulting output at the caret. If 
it’s a pending-delete selection, the output from the filter replaces it. See 
Chapter 6, All About Selections, for a discussion of pending-delete selections 
and the get_selection command. 

□ You can associate a text filter with an unused function key. See Chapter 4, 
All About Keyboards, for information on how to “map” a function key to a 
filter. 


A command window is a text window that includes a command inteipreter and 
lets you bring up a Text menu. Command Tool displays a command window. 

The command line is the line that is communicated to the command interpreter. 
It’s usually the last line of text in the command window. When you press the 
(Return ] key, the text on the command line is sent to the command interpreter, 

which runs the command you requested. The command that’s running often 
sends messages back to the command window. This conversation is known as a 
dialog. Generally the command line begins with d, prompt like the venus% 
prompt seen in this manual. The comnu'ind interpreter prompts you when it’s 
ready to receive the next command (bui you can type ahead). 
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The text on the command line in a command window can te edited just the way 
you edit in a text window — you can cut, paste, copy, and use secondary selec¬ 
tions. (In a tty window, by contrast, editing is limited.) 

The text that’s not on the command line is normally read-only. You can’t edit it 
unless you specifically ask to do so by using the ‘Cmd Modes=>’ puU-right menu 

in the Text menu. ‘Cmd Modes=>’, which isn’t found in text window Text 
menus, has special features specific to command windows — it lets you turn edit¬ 
ing and scrolling on and off. 


Changing Command Modes The Text menu in a command window contains a pull-right menu that doesn’t 

appear in text window Text menus: the ‘Cmd Modes=>’ pull-right menu. 

Normally you can edit only the command line. The ‘Cmd Modes=i>’ pull-right 
menu lets you change the transcript in the command window by editing any text 
in the window. The transcript is a record of the interactive dialog between the 
user and the shell. 

You can also mn tty-based programs in a command window. Well-behaved tty- 
based programs cause the scrollbar to disappear when they start, and restore it 
when they’re done. If you want to run a program that doesn’t do this for you 
automatically, the ‘(Ynd Modes=>’ pull-right menu lets you disable and reenable 
scrolling in the command window. See CHiapter 8, All About Menus, for more 
information on ‘Cmd Modes=>’. 


5.4. Panels 

[Blink Ouner] 


A panel is a window that lets you control an application by means of various 
panel items such as panel buttons, choice items, and panel text items. 

Panel buttons are used to specify an action. Nothing happens until you “push” 
the panel button by clicking LEFT or choosing from its menu. The panel button 
turns gray while the action is taking place. 

Choice items are used to set options. You can set a number of choice items 
before choosing an action. There are many ways to depict a choice in a panel, 
including: 





o Cycle items. 

o Choice buttons. 

□ Check boxes. 

□ Sliders. 


The way choices are shown depends on the application. For example, the Find 
Marked Text pop-up frame (shown in Figure 5-2) contains choice buttons, while 
the Defaults Editor Control panel uses cycle items. 
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Figure 5-2 Choice Buttons in the Fled Marked Text Frame 
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Editing Panel Text Items You can edit a panel text item, with these provisos: 

□ You can’t type, paste, or delete characters in a panel text item except at its 
end. 

□ You can’t select part of a panel text item. When you click LEFT on any part 
of a panel text item, the entire panel text item is selected. This means that 
‘Copy’ can’t copy part of a panel text item. 

o Subject to the restrictions mentioned above, you can copy and paste between 
text windows, command windows, and panel text items; and you can use the 
quick-editing features of secondary selections with Copy, Paste, and Cut. 

For more information about secondaiy selections, see Chapter 6, All About Selec¬ 
tions. For more information about text-handling differences among windows and 
panels, see Table 6-3. 


Alert Windows Alert windows are actually panels and work the way other panels do. A large 

black arrow sweeping in from the left readily identifies a window as an Alert 
window. 

Alert windows contain a message and one or more buttons that you push. 
Figure 5-3 Alert Buttons 



The arrow alerts you to read the question or message in the window, and respond 
accordingly. Often the buttons are Confirm and Cancel, but there may be more 
than two, depending on the message. 

The button that represents the yes choice has a double outline. The pointer is 

automatically moved over this button for you. 
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Accelerators for Alert Buttons 


5.5, Tty Windows 


The Block Cursor 


What to do if a tty application leaves 
your Command Too! without restor¬ 
ing the scrollbar.... 


5.6, Canvases 


5.7, Managing Multiple 
Frames 
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If the alert button you want is labeled Conirm, or another obvious yes, you can 
press tlie (R^um 1 key instead of pushing the button. 

The alert button that’s activated by the [Return 1 key is accented by a double out¬ 
line, like the Confirm button in Figure 5-3. 

If the alert button you want is laMed Cancel, or another obvious no, you can 
press the [Stop] function key instead of pushing the button. 


Tty (for teletype) windows don’t give you all the beUs and whistles of SimView, 
but some applications can’t run in any other environment. Shell Tool provides 
an environment for applications that need a tty window. You can also request a 
tty window in Command Tool by choosing ‘Omd Modes=>Disable Scrolling’ 
from the Text menu. 

A tty window is essentially a command window without scrolling. Editing in the 
tty command line is limited. The only deletion allowed in the command line is 
backspacing from the end of the line. You can make secondary selections in a tty 
window and you can store the primary selection on the Qipboard, as in text win¬ 
dows. You can also copy text Ixtween tty windows and text windows. 


The tty window has its own insertion point, called a block cursor. It’s a black 
rectangle when the tty window has the keyboard focus; when the focus is else¬ 
where, it’s an outline of the cursor’s rectangle. Like the caret in a text window, 
the block cursor represents the insertion point. Unlike the caret, the block cursor 
never blinks. 

When you run a command in Command Tool that requires a tty window, the 
change is usually made for you automatically, and when the command has com¬ 
pleted, it changes the window back. For example, when you run vi in Com¬ 
mand Tool, the scrollbar disappears. When you type : q, the scrollbar returns. 

If you need to run a non-standard program that doesn’t do its own setting up, you 
can change Command Tool to a tty window yourself by choosing the ‘Cmd 
Modes=»Disable Scrolling’ from the Text menu. To change back, choose 
‘Enable Scrolling’ from the Tty menu. 


A canvas is a window that displays unformatted images. It’s used for drawing. 
For example, the Icon Editor contains a canvas where you can draw and erase 
images by using the mouse. For more information about the Icon Editor, see 
Chapter 11, All About Tools, and the iconedit command in the SunOS Refer¬ 
ence Manual. 


Deciding how to arrange your SunView screen is as personal as deciding how to 
arrange your living room. Everyone has a slightly different idea of what works 
best. (And a few people have radically different ideas.) A few things to keep in 
mind are discussed below. 
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‘Move=>’ and 'Resize=»’ in the 
Frame menu let you rearrange 
frames to suit your needs. 


‘Back’ and ‘Front’ in the Frame 
menu expose and hide overlapping 
frames. 


Speed vs. flexibility. 


‘Services=>Save Layout’ in the Sun- 
View menu saves the current layout 
of the screen. 


‘Redisplay All’ in the SunView menu 

refreshes the entire screen. 
‘Redisplay’ in the Frame menu 
refreshes the display of the frame. 


You can shape frames to suit your needs under different circumstances. The 
Console is an example of this. It’s quite small, and it’s teen placed out of the 
way. You will probably have at least one other Command Tool open, and you 

will want it large enough so you can comfortably list directories and display files. 

Overlapping frames are very flexible in SunView. You can move the keytoard 
focus to a frame that’s overlapped and type, paste, save or store the file, do all the 

operations that the application lets you do, even if you can’t see everything 
because part of the window is hidden. 

There’s a price to pay, though. Overlapping frames take longer to redraw when 
you open or close one of them or move one of them. If you’re concerned about 

speed, minimize your use of overlapping frames. 

Once you get an arrangement that’s convenient, it’s nice to have a way to get 
back to it if you happen to change it temporarily, or if someone uses your woiks- 

tation, or.... 

‘Save Layout’ remembere the current arrangement by storing it in the . sun- 
view file, which is read when you start SunView. If you have favorite screen 
arrangements for different tasks, you can save one, rename it 

. sunview_debugging, save another, rename it . sunview_writing, and 
so on. 

Then, the next time you restart SunView, choose the arrangement you want by 
specifying the -s option and the filename: 






Venus % sunview -s . siinview__writing 


V 


J 


It may happen that the screen display is corrupted by a malfunctioning applica¬ 
tion (for instance, when you’re testing a new SunView program). You can 
request a redisplay to refresh the entire screen or an individual frame. You prob¬ 
ably won’t have to do this very often, but it’s there when you need it. 
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6.1. Mouse, Pointer, Caret, 
and Block Cursor 


About the Mouse 




All About Selections 


This chapter covere the following information: 
o The mouse and the pointer. 

□ The caret and the block cursor. 

□ Selecting text and extending a primary selection. 

□ Erasing text. 

□ Copying, pasting, and cutting selections. 

□ Pending-delete selections. 

□ Quick editing with secondary selections. 

□ The get_s elect ion command. 

When you select text, you identify it to the system so that it can be recognized 
for use in editing and other operations. 

Here’s a quick summary of terms. 

The mouse is used to move the pointer on the screen. To make a selection, you 
move the pointer with the mouse and click LEFT. The caret marks the insertion 
point in a text or command window. You set the caret by making a selection. 
The block cursor marks the insertion point in a tty window. In a tty window the 
block cursor is always at the end of the command line. 

The mouse translates physical motion into electronic signals so that you can 
move the pointer on the screen. For example, you use the mouse to point to text 
in a window that you want to select. 

The mouse sits on a pad, a silver plate with a blue grid. The tail of the mouse is 
a wire connected to the back of your workstation. The mouse should be posi¬ 
tioned so that its short side is parallel to the long side of the pad, with the red 
light facing down and the three lozenge-shaped mouse buttons facing up.^ 


^ Hus description of the optical mouse doesn’t apply to the mechanical mouse. If you have a mechanical 
mouse with a rolling ball cm the bottom, you dcxi’t have to align the mouse to the pad. 
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Grip the sides of the mouse with your thumb and pinkie, with your fingers resting 
on the mouse buttons. Move the mouse in circles on the pad and the pointer 
makes circles on the screen. 


About the Pointer 







You position the pointer over SunView objects to make selections, choose menu 
items, push panel buttons, and so on. 

The pointer’s shape changes as you move it. The shape gives you information 
about where the pointer is positioned and what action is taking place. 

Each pointer has a hot spot — the place on the pointer that acmaUy does the 
pointing. For example, the hot spot in an arrow pointer is the tip of the arrow, 
and the hot spot in a target pointer is the middle of the target. The pointers are 
designed so that you’U intuitively use the hot spot correctly. 

Here are some standard SunView pointer shapes (some applications may use 
additional shapes). 

The basic pointer shape, which you see when you bring up SunView, is the 
“northwest” arrow. This is the shape that appears in most windows and on the 
background. 

The pointer changes to a target when it’s over an icon, a frame header or any part 
of the frame border. You can’t bring up the Frame menu unless you see a target. 

When a tool is busy with an action, such as retrieving new mail in Mail Tool, the 
pointer in its frame may change to an hourglass. This means the tool won’t 
respond to you until it’s finished, but you can mouse ahead or type ahead. You 
can also continue working in other frames where the pointer shape is normal. 

When you choose ‘Enable Page Mode’ from the Tty menu, the pointer in the tty 
window changes to a stop sign whenever there’s more than one windowful of 
text to display. The stop sign means, “The display has stopped but there’s more 
to come.” 


The right arrow pointer for menus reminds you to pull right on pull-right menus. 


Scrollbar Pointer Shapes 




The pointer changes to a diamond when it’s in a scroll box. 
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i 


The pointer changes to a right-facing arrow when the pointer is in the scrollbar 
(anywhere except the scroll boxes). 

When you click or hold down the LEFT or RIGHT mouse button, during scrolling 
the pointer changes to an up or down arrow to tell you the direction of scrolling. 


When you click or hold down the MIDDLE mouse button in any part of the 
scrollbar, during scrolling the pointer changes to a right-facing triangle. 


About the Caret The caret is a symbol that appears in text windows, command windows, and 

panel text items to indicate where the next insertion will go. It sits just below a 
line of text and points upward between adjacent characters. 

A When the keyboard focus is in the window, the caret is black, triangle-sha^d, 

and blinking. 

At other times, the caret is gray, diamond-shaped, and non-blinking. 

The terms caret and insertion point can be used interchangeably. To set the 
insertion point in text, move the pointer to the location you want and click the 
LEFT mouse button. The caret moves to the new location and makes a one- 
character selection. You can extend the selection by clicking the MTODLE mouse 
button. 

After you type or paste text: 
o The text is where the caret was. 

□ The caret is at the right of the inserted text. 

□ There’s no selection. 


About the Block Cursor 

I 

D 


The block cursor is found only in tty windows. It represents the insertion point, 
which in a tty window is always at the end of the command line. 

Unlike the caret, the block cureor sits on the line, not below it, and it never 
blinks. Its shape is a tall rectangle — solid black when the keyboard focus is in 
the tty window, outlined when it’s not. 

To make a selection in a tty window, move the pointer to the location you want 
and click the LEFT mouse button. You can then extend the selection with the 
MIDDLE mouse button. 


6.2, Primary Selections Selections are a way of specifying operands for Text menu operations like ‘Load 

File’. Selections also act as operands for some function key operations, like 
(Cut) , and for some keyboard accelerators, like (T-Sl . (See Oiapter 4, All About 
Keyboards, for information on the Meta (♦) keys.) 
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Selecting a Character 


Extending the Selection 


Primary selections are nonnal SunView selections. They’re highlighted in 

inverse video (black on white) and last until you type, paste, or make another 
selection. 

Here are the basic operations you need to know when working with text in Sun¬ 
View. 


To select a single character in a text window or command window: 

□ Move the pointer over the character and click the left mouse button. The 

one-character selection is highlighted. 


Select a candidate 


In a panel text item, the entire text item is selected when you click LEFT. 


To select more than one character: 

□ Select the first or last character by clicking LEFT on it. 

o Extend (or adjust) the selection by pointing to the other end of the span and 
clicking MIDDLE. 



a candidate 


Alternatively, you can wipe to make and extend a selection. Many personal com¬ 
puters work this way. Wiping works only when there’s no selection in the win¬ 
dow. 

To make a selection by wiping: 

o Hold down the MIDDLE mouse button to start the selection. 

□ Move the pointer to the end of the text you want to select, and release the 
mouse button. 

You can extend a selection as many times as you like, and you can adjust either 
end of the selection. When you hold down MIDDLE, the end of the selection 
closest to the pointer is adjusted. You can make a selection larger or smaller 
when adjusting it. 
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The Insertion Point 


6.3. Basic Editing 


Inserting Text 


When you click the LEFT or MIDDLE mouse button, two things happen: 
o One or more characters are selected. 

□ The insertion point is specified. 

The insertion point is the place where the next character you insert will go. The 
caret, a blinking triangle, represents the current insertion point. When you make 
a selection, the caret appears at the end of the selection closest to the pointer. 

The insertion point is always between characters. For example, to place the 
insertion point between letter m and u in the word muse, position the pointer 
anywhere between the middle of m and the middle of u, then click left. 


I can always get a pointer from m 



To insert text, just type. Here’s what happens if you type o: 


I can always get a pointer from my mc^use. 


The basic editing operations are: 

□ Insert —type or paste. 

□ Erase — remove text from the document. 

□ Delete — remove text and place it on the Clipboard. 

□ Duplicate — make a copy of text at another location. 

□ Move — remove text from its present location and place it somewhere else. 

o Replace — delete text and move or duplicate other text to take its place. 

Text windows let you do any kind of editing. Command windows, tty windows, 
and panel text items are subject to a few restrictions, as summarized in Table 6-3, 
Text Handling in Windows and Panels, later in this chapter. 


To insert characters in a text window, simply place the caret where you want the 
characters to go and start typing. Unlike vi, for example, the Text Editor has no 
special insert mode. 

Another way to insert text is to paste the contents of the Clipboard at the caret by 
choosing ‘Edit=>Paste’ from the Text menu. 
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Erasing a Character 


NOTE 


Erasing Words 


Erasing Lines 


Deleting Text 


Reinserting Deleted Text 


Deleting Line Breaks 


Erasing usually works on the text immediately to the left of the caret. To erase 

the previous character, press the I Delete! key. 

You can erase the character immediately to the right of the caret by pressing 

(Shift-Delete i . 

( Shift-Delete I means hold down the 1 Shift I key while you press the I Delete 1 key. 

The I Shift 1 key often toggles — reverses the direction of an operation — esf^- 
cially when used in conjunction with text fimction keys. 


To erase the word to the left of the caret, press (Control-W~l . 

To erase the word to the right of the caret, press f Shift-Control-W 1 . 


To erase the current line leftward from the caret to the beginning of the line, 
press [ Control-U 1 . If the caret is already at the beginning of the line, f Control-U 1 
has no effect. 

To erase the current line rightward from the caret to the end of the line, press 
[ Shift-Control-U 1 . If the caret is already at the end of the line, (Shift-Control-U I 
has no effect. 


To delete text, select it, then choose ‘Edit=>Cut’ from the Text menu or press the 
(Cut! function key. You can also use the I ♦-X1 keyboard accelerator. The use 
of the Meta (♦) keys is described in Chapter 9, All About Accelerators. 

‘Cut’ is a deleting operation. Unlike erasing, deleting “remembers” the text that 
you removed, so you can reinsert it. 

Whenever you delete a selection, it’s automatically stored on the Qipboard for 
later use. To see the contents of the Clipboard, choose ‘Edit=>Show Qip¬ 
board =>’ from the Text menu. (For more information about displaying the Clip¬ 
board, see ‘Show Clipboard=^' in Chapter 8, All About Menus.) 


‘Edit=»Paste’ copies the contents of the Clipboard to the insertion point. To rein¬ 
sert text you just deleted: 

□ Press the 1 Paste 1 function key, or choose ‘Edit=>Paste’ from the Text menu, 
or press I ♦-V 1 . The deletion is inserted at the caret. 


When you erase a newline character, you join two lines into one. The newline 
character is inserted in a document when you press the { Return" I key or the 

{Line Feed ) key. 
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6.4. Copying, Pasting, and Editing frequently requires copying and pasting or cutting and pasting. You can 

Cutting perform these operations in any of the ways shown in Table 6-1. Here are a few 

examples: 

o When you have a long pathname in a command window that you don’t want 
to retype, you can copy and paste. 

□ When you want to duplicate a format you’ve used earlier in a document, you 
can copy and paste in a text window. 

□ You can cut and paste in a Mail Tool composition window to move a para¬ 
graph from one place to another. 

Copying doesn’t affect the text you copy. Cut removes the selection from its 
current location. Paste puts it in a new location. Copying and cutting both put 
the selection on the Clipboard. Paste inserts the contents of the Clipboard at the 
caret. 

Table 6-1 Copy, Paste, and Cut—Alternative Methods 


Menu Item 

Function Key 

Menu Accelerator 

‘Edit=>Copy’ 

(Copy] 

[♦--c-j 

‘Edit=>Paste’ 

1 Paste 1 

14-Vj 

‘Edit=>Cut’ 

f Cutl 

1 ♦-Xl 


The examples in this chapter use the function keys to copy, paste, and cut, but 
you can use any of the methods shown in Table 6-1. The Meta (♦) keys are 
described in Chapter 9, All About Accelerators. 
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Copying and Pasting a 
Selection 


The ( Copy I function key stores selected text on the Clipboard without deleting it 
from the document. The example shows how to copy the filename 
original. limerick from a listing in the command window to the com¬ 
mand line in the same window. (The head -1 command lists the first line of a 
file. See the SunOS Reference Manual for more information about the head 
command.) 

To copy text from one location to another: 

□ Select the text you want to copy and press f Copv1 . 



□ Select to set the new insertion point if necessary. 

□ Press [ Paste I to copy from the Clipboard to the insertion point. 



w 

venus% cd ^ 



/usr/nutmeg/sages 



venusT# Is *1im* 



lessonl. 1Imerick original.limerick 

original.1imerick% 


venus% head -1 original . 1imerick 
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Cutting and Pasting a 
Selection 


The rCiitl fiinctioe key deletes selected text from the document and stores it on 
the Qipboard. The example shows how to delete the word Cajun, together with 
the space following it, and paste them in front of the word catfish. 

To move a selection from one location to another: 

□ Make the selection and press f Cut 1 . The selection is deleted and placed on 
the Clipboard. 



£ 

Scratch window | 


Dear Diary, 


This is the third day of my California Yuppie Diet. 


Today I ate blue cornmeal pancakes for breakfast,^ 


KRnMsushi for lunch, and catfish for dinner. \ 

1 

Tomorr*bw, will have sprouts and sun-dried tomatoes. 


□ Select to set a new insertion point if necessary. 


textedif' - . (NONE) r: /usr/nutmeg/sage 


I*1 Scratch uiindouj 


a 


Dear Diary, 

This is the third day of my California Yuppie Diet. 
Today I ate blue cornmeal pancakes for breakfast, k 
for lunch, andlpatfish for dinner. ^ 

grouts and sun-dried tomatoes. 


sushi 

Tomorrow, will have 


□ Press (Paste 1 to copy from the Clipboard to the insertion point. 


textedit - (NONE), dir: /usr/nutmeg/sages 


^[Scratch window 


Dear Diary, 

This is the third day of my California Yuppie Diet 
Today I ate blue cornmeal pancakes for breakfast, 
sushi for lunch, and Cajun catfish for dinner. \ 
Tomorrow, will have sprout^ and sun-dried tanatoes, 
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Cutting and Typing 


As soon as you’ve cut text, you’re ready to start inserting a replacement. The 
example shows you how to change salad to soup. 

To replace a selection by typing; 

o Select the text you want to replace. 


textedit - (NONb), dir: /usr/nutmeg/sages 


t Scratch window 

_____di- 


Dear Diary, 

California Yuppie Diet, day 10 
tomorrow I'll have watercress 


Let' s see... 


salad 


° Press (Cut I . The insertion point is now where the deleted text was. 




Scratch window^ || 

1 

Dear Diary, 

California Yuppie Diet, day 10. Let's see.,. \ 
tomorrow I'll have watercress 


□ Type the replacement text. 



II ^ 

II ▼ 

Scratch windouj 

1 

Dear Diary, 

P 

California Yuppie Diet, day 10. Let's see... ^ 

I'i 

tomorrow I'll have watercress soup. 

A 
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Copying Text Between 

Windows 


You can copy or move a selection from one window to another window the same 
way you did within a single window. The example shows you how to copy 
watercress salad from a listing in a Command Tool window into a Text 
Editor document: 

□ Make the selection in one window and press f Copy 1 . 



w 

▲ 

venus% cat yuppie_food 

pine nuts gourmet granola baby carrots 

venus% A 


1 

Scratch luindou 

1 

Dear Diary, 

California Yuppie Diet, day 10. Let's see... 

1 

tOTorroju I'll have 

❖ 


□ Move the pointer into the other window. Select to set the insertion point if 
necessary. (In this case, the caret is already where you want to Paste.) 




venus% cat yuppie_food 
pine nuts gourmet granola 

baby carrots 

•y 

radicchio 

venus% 

purple potatoes 



Scratch window 


fT 

Dear Diary, 


; 1 

California Yuppie Diet, day 10. 

Let's see... 

J 

tomorrcxjj I'll have 

& 
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° Press f Paste. I 



You can also move text from one window to another in the same way, using 
(Cut I instead f Copy 1. 


6.5. Undoing Editing Sometimes you realize that you’ve just edited something you wish you hadn’t. 

The Undo operation is a way of restoring the text window to its previous state. 
Undo undoes whatever editing you did since the last time you either made a 
selection or performed a Copy, Paste, or Cut. 

Each window keeps its own Undo information — unlike the Cliplx)ard, which all 
windows share. 

□ To undo the most recent editing, choose ‘Undo Last Edit’ from the 
‘Edit=^>Undo=>’ pull-right menu in the Text menu, or press the ! Undo 1 func¬ 
tion key. The keyboard accelerator for ‘Undo Last Edit’ is I ♦-!! I . 

CAUTION There is no way to Undo an Undo. 

A second ‘Undo Last Edit’ undoes the changes you made since the previous 
insertion point change. You can continue to undo by “changed insertion point” 
intervals up one of the following limits, whichever comes first: 

□ The limit specified in the Defaults Editor (the default limit is 50 intervals). 

□ The last ‘Save Current File’ or ‘Load File’. 

You may want to undo all your edits at once, back to the last time you saved the 
file. For example, you save your document and then push the Replace AH button 
in the Find and Replace frame. Afterwards you discover you inadvertently 
replaced with dental mint instead of mental dint throughout the docu¬ 
ment. 

□ To revert to the state of the file after loading or saving, whichever is most 
recent, choose ‘Undo All Edits’ from the ‘Edit=>Undo=^’ puH-right menu. 
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6.6. Selecting by Multi- 
Clickleg 

You can double-, triple- or 
quadruple-click to select words, 
lines, or the entire document, 
respectively. 


Multi-clicking is a short-cut that lets you select a word, a line, or the whole docu¬ 
ment without having to extend the selection. 

When you make a selection by multi-clicking, the caret appears at whichever end 
of the selection is closest to where the pointer was. For example, when you 
double-click any where to the left of the letter u in the word petunia, the 
caret apf^ars before the letter p. 

Using multi-clicking, you can easily position the caret teforc or after a word, or 
at the teginning of a line. 

When you click LEFT, a character is selected. 

To select a word: 

□ Point at any character in the word and double-click LEFT. The main attrac¬ 
tion of word selection is speed and convenience — you don’t have to care¬ 
fully select the first and last charactere in the word. A word is one or more 
alphanumeric characters plus underscore (_) bounded by non-alphanumeric 
characters, or vice versa. For example, yankees/mickey_inantle con¬ 
tains three words (yankees, /, and mickey_mantle), while 
yogi_berra_and_joe_dimaggio_and_casey_stengel contains 
only one word. 

To select a line: 

o Point anywhere in the line and triple-click LEFT. 

To select the entire document: 

□ Point anywhere in the window and quadruple-click LEFT. 

Whether two clicks are interpreted as a double-click or not depends on the time 
between clicks. You can adjust SunView’s sensitivity to multi-clicking by 
changing the Defaults Editor’s Text/Mult i_click_space and 
Text/Multi_click_timeout settings. 


Extending a Multi-Click When you select a word by double-clicking and extend the selection, the selec- 

Selection tion is extended in units of a word. Similarly, when you select a line by triple¬ 

clicking, the selection is extended in units of a line. This means you don’t have 
to get too precise when pointing to the end of the extended selection, but it also 
means that the extension is only as precise as the multi-click unit (words or 
lines). 

There is a way to adjust a multi-click selection precisely: 

□ Point to the very end of the selection — whichever end you want to adjust. 

o Hold down the MIDDLE mouse button and wipe through the selection until 
it’s the way you want it. You can wipe one character at a time. 
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Figure 6-1 Extending a Multi-Click Selection 


textedit - dQver_beachj dir: /home/nutmeg/sages 


1 1 .A. 

II "y 


1 

The sea is calm tonight. 

ili 

The tide is full, the moon lies fair 

la 

Upon the straits:--the French coast the light 

■ 

Gleams and is gongixhe cliffs of England stand 

ir."* 

Glimmering and vast, out in the tranquil bay. 


Come to the window, sweet is the night air! 


As shown in Figure 6-1, to select text that begins with the phrase on the 

French coast and ends with the phrase and is gone, point anywhere in 
the word on, double-click LEFT, then point anywhere in the word gone and click 
MIDDLE. 

No matter how many times you clicked to make the selection, you extend by 
clicking MIDDLE once. 


6.1, Secondary Selections A secondary selection is a temporary selection you make while holding down a 

function key. The action takes place when you release the function key. This 
feature lets you do many Copy, Paste, Cut, and Find shortcuts with function 
keys. 

secondary 

selection secondary selection is always underlined. It lasts only as long as you hold 

down the ftinction key. During that time, you can adjust the secondary selection 
the same way you adjust a primary selection. 

You can also scroll while making a secondary selection, as long as you continue 
to hold the function key down. That way, you can adjust the selection to encom¬ 
pass charactere that aren’t currently visible in the window. 

With secondary selections, you can do editing operations that require both a 
source and a destination, such as duplicating and moving text. Secondary selec¬ 
tions also let you perform an operation without changing the current primary 
selection and insertion point. 

You’ve already learned one method for copying text from one place to another: 

□ Select some text and press f Coovl . 

□ Select the destination and press I Paste l . 

For an easier way to duplicate text, use secondary Paste. This example changes 
strawberry to strawberry vanilla: 
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□ Click LEFT to set the caret where you want the text copied. 




ice cream 

"W ^ 

vani11a 
coffee 
straujberryi 
chocolate CTip 
coconut almond fudge 
maple banana nut 


o Hold down the (Paste) key while selecting the text to be copied. The text is 
underlined to indicate that it’s a secondary selection. 


mrpBpnTTiii 1 ip III yi ii —nrpurMn—ipiwwini i iiiiiiiw p'lPaipiaTpiiiiip 

£ 

ice_cream || 

A. 

▼ 

•w 

vanilla . | 
coffee ' 1 
strawberry! I 
chocolate chip I 
coconut almond fudge I 
maple banana nut 1 


□ Release the 1 Paste) key. The secondary selection is pasted at the caret. 



£ 

ice_cream || 

Ii 

Ii 

I-:';-'’- ■ 

t 

vani11 a 
coffee 

strawberry vanilla k 
chocolate chip 
coconut almond fudge 
maple banana nut 


NOTE When you use secondary Paste to get text from another window, be sure the 

pointer is in the "to” window when you first press the f Paste 1 key; otherwise the 
keyboard focus will shift and you’ll paste in the "from” window. The secondary 
selection is pasted into the window that has the keyboard focus at the time you 
press the function key. 
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You can use secondary selections to specify operands for rt^oDvl . fFastel . and 
[ Cut 1 . as weU as for (Find 1 . 

To delete text without changing the insertion point, use secondary Cut: 

□ Hold down the f Cutl key while selecting the text you want to delete. 

□ Release the (Cut] key. The text is deleted and placed on the Clipboard. The 
caret remains in its original position. 

To set the insertion point for the destination without losing the primary selection, 
use secondary Copy: 

o Make a primary selection. 

□ Hold down the ( Copy 1 key while setting the caret by clicking LEFT. 

□ Release the (Copy I key. The primary selection is copied to the left or right 
of the secondary selection, depending on which end you clicked nearest to. 
The caret moves to the end of the insertion. 


Finding a Secondary Selection To search for a secondary selection, hold down the [ Find) key while selecting 

text. The secondary selection is searched for when you release the function key, 
and the first occurrence that’s found is highlighted. The search is in a forward 
direction, but you can reverse it by holding down (Shift-Find I while selecting 
text. This is a handy way to search without changing the Qipboard or the current 
primary selection. Note that the search begins at the caret, not at the secondary 
selection. 


Stopping a Secondary 
Selection 


NOTE If a text window gets stuck so it makes only secondary selections, press the f Stop I 
key to reset the window. 


When you start a secondary operation — for example, hold down (Paste 1 and 
select some text — and then decide you don’t want to complete the operation, 
press the i Stop 1 key to reset the window. 


6.8. Peeding-Delete 
Selections 






When you want to replace a selection immediately after you make the selection, 
pending-delete selections make your job easier. A pending-delete selection is 
replaced the next time you type or Paste. 

Pending-delete primary selections are highlighted in dark gray. Think of the 
characters as being less visible because they are fading away, soon to be gone 
altogether. 

A pending-delete selection can also be used as an ordinary selection; for exam¬ 
ple, to specify a filename for ‘Load File’. 

□ To make a primary selection pending-delete, hold down the 1 ControTl key 
while selecting or adjusting the selection. 

A pending-delete selection is actually deleted only when you insert or type some¬ 
thing over it. When you make a new selection without performing any operation 
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or inserting any characters the pending-delete selection isn’t affected. 

You can change an existing selection to a pending-delete selection by holding the 
[ Control I key down and adjusting the selection, in other words, clicking MIDDLE 
while pointing at one of its endpoints. The original selection becomes a 
pending-delete selection. 

You can remove the {^nding-delete status of a selection by performing the 
reverse operation: adjust the selection by pointing at one of its endpoints while 
the [ Control 1 key is not held down. 

Pending-delete secondary selections are underlined and highlighted in light gray. 

□ To make a secondary selection pending-delete, hold down the (ControD key 
together with the function key. 

The following example shows you how to use a pending-delete secondary selec¬ 
tion to move the word positive from the middle of the sentence to the end. 

To move text from one location to another: 

□ Set the caret at the destination. 



l£ 

.-.- 

1 

Accentuate the positive advantages of the product 
and your sales curve will ^ 


□ Hold down the I Control I and f Paste I keys. 

□ Select the text you want to move. The selection is underlined to indicate 
that it’s a secondary selection and highlighted to indicate that it’s pending- 
delete. 



|£ 


1 

Accentuate advantages of the product 

and your sales curve wil^ be| 


□ Release the f Control 1 and (Paste 1 keys. The secondary selection is inserted 
at the caret. 







|£ 

II 

1 

Accentuate the advantages of the product I 

and your sales curve will\be positiv^ I 


What’s more, if the destination is a pending-delete primary selection, the primary 
selection is deleted and placed on the Clipboard. 
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6.9. Quick Editing with The use of secondary and pending-delete selections provides a streamlined way 

Secondary Selections of moving, copying, and replacing text Here’s a summary: 

□ Use pending-delete selections to mark text for deletion (hold down the 
(Control 1 key while making the selection). 

□ Use secondary Paste to move or copy text there-to-here, in other words, 
from somewhere else to the caret. When you’re working in a tty window 
such as Shell Tool, secondary Paste is the equivalent of ‘Stuff. 

o Use secondary Copy to move or copy text here-to-there, in other words, 
from the caret to somewhere else. 

□ Use secondary Cut to delete text without affecting the caret. 

□ Use swapping to make the primary selection and the secondary selection 
change places. 

In the techniques described below, here means where the caret is, there means 
elsewhere. 1 Control-Paste 1 means hold down the I Control 1 key and the I Paste 1 
key at the same time. 

These methods work for text and tty windows as well as panels, although tty win¬ 
dows do not support deletion. 

Table 6-2 summarizes all the quick-edit techniques that use secondary selections. 
To use these techniques, first make the primary selection, then make the secon¬ 
dary selection. The techniques are described in detail following the table. 
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Table 6-2 Quick Editing with Secondary Selections 


To do this... 

Make primary 

selection... 

Make secondary 
selection using... 

DUPLICATE HERE: 

Copy secondary selection 
to caret. 

normal or none 
(sets caret) 

(Paste) 

MOVE HERE: 

Move secondary selection 
to caret. 

normal or none 
(sets caret) 

(Control-Paste 1 

DUPLICATE AND REPLACE HERE: 

Copy secondary selection 
to replace primary selection. 

pending-delete 

(Paste 1 

MOVE AND REPLACE HERE: 

Move secondary selection 
to replace primary selection. 

pending-delete 

(Control-Paste 1 

DUPLICATE THERE: 

Copy primary selection 

to left or right of secondary selection 

without moving caret. 

normal 

LCopyJ 

MOVE THERE: 

Move primary selection 

to left or right of secondary selection 

without moving caret. 

pending-delete 

ICopyJ 

DUPLICATE AND REPLACE THERE: 

Copy primary selection 
to replace secondary selection 
without moving caret. 

normal 

(Control-CoDvl 

MOVE AND REPLACE THERE: 

Move primary selection 
to replace secondary selection 
without moving caret. 

pending-delete 

(Control-CoDv 1 

DELETE THERE: 

Delete secondary selection 
without affecting 
primary selection or caret. 

normal, none, or 
pending-delete 

1 Cut 1 

SWAP: 

Exchange locations 
of primary selection 
and secondary selection. 

pending-delete 

i Control-CoDv 1. 
then regular 

1 Paste). 
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Secondary Paste 


Secondary Paste operations let you edit there-to-here, moving or copying text to 
the caret. 

Duplicate Here 

To copy text to the caret: 

□ Hold down f Past^ while selecting the text. The selected text is under¬ 
lined. 

□ Release I Paste 1 . The text is copied at the caret. 

Move Here 

To move text from its original location to the caret: 

□ Press (Control-Paste 1 while selecting the text. The selected text is under¬ 
lined and grayed. 

□ Release I Control-Paste 1 . The text is removed from its original location 

and pasted at the caret. 

Duplicate and Replace Here 

To copy text to replace the primary selection: 

□ Make the primary selection pending-delete (hold down ITontroIl while 

selecting). 

° Press ! Pastel while selecting the replacement text. The secondary selec¬ 
tion is underlined. 

□ Release t Paste 1 . The primary selection is deleted and placed on the 
Qipboard. The secondary selection is inserted where the primary selec¬ 
tion was. 

Move and Replace Here 

To move text from its original location to replace the primary selection: 

o Make the primary selection pending-delete (hold down I Control 1 while 

selecting). 

□ Press I Control-Paste I while selecting the replacement text. The replace¬ 
ment text is underlined and grayed. 

□ Release fControI-Paste 1 . The primary pending-delete selection is placed 
on the Qipboard and the replacement text is moved from its former 
location to where the primary selection was. 
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Secondary Copy 





Secondary Copy operations let you edit here-to-there. The location of the caret 

doesn’t change. 

Duplicate There 

To copy the primary selection to another location without moving the caret: 

□ Make a primary selection. 

o Hold down I Copy I . then click LEFT at the new location. The new loca¬ 
tion is underlined. 

□ Release I Conv I . The selection is copied to the new location — to the 
left or right of the underlined text, depending on which end you clicked 
nearest to. The caret stays where it was. 

Move There 

To move the primary selection to another location without moving the caret: 

□ Make the primary selection pending-delete (hold down \ Control 1 while 
selecting). 

□ Hold down I Copy 1 while selecting the new location by clicking LEFT. 
The new location is underlined. 

o Release I Copy I . The primaiy selection is moved to the new location — 
to the left or right of the secondary selection (the underlined text), 
depending on which end you clicked nearest to. The caret stays where 
the primary selection was. The Clipboard is not changed. 

Duplicate and Replace There 

To copy the primary selection to replace text at another location without 

moving the caret: 

□ Make a primaiy selection. 

□ Hold down I Control-Copy 1 while selecting the text to be replaced. The 
text to be replaced is underlined and grayed. 

□ Release 1 Control-Copy I . The primary selection is copied, replacing the 
secondary selection (the text to be replaced), and the secondary selec¬ 
tion goes on the Clipboard. 

Move and Replace There 

To move the primary selection to replace text at another location without 

moving the caret: 

□ Make the primaiy selection pending-delete (hold down I Control I while 
selecting). 

□ Hold down [ Control-Copy 1 while selecting the text to be replaced. The 
text to be replaced is underlined and grayed. 

n Release I Control-Copy I . The secondary selection (the text to be 

replaced) is deleted and placed on the Qipboard. The primary selection 
moves to where the secondary selection was. The caret stays where the 
primary selection was. 
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Secondary Cut 


Secondary Cut erases text anywhere in the document without changing the inser¬ 
tion point. 

Secondary Cut is useful when you’re typing along and notice something you 
want to delete. It lets you delete the text without moving the caret, so you can 
delete someplace else and go right on typing. 

Delete There 

To erase text without moving the caret: 

o Press I Cut I while selecting the text to delete. The secondary selection is 
underlined and grayed. 

□ Release [ Cut 1 . The secondary selection is deleted and placed on the 
Qipboard. The caret stays where it was. 
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Here’s a fast way to swap text using secondary selections. The example shows 
you how to exchange items in a list. 

Swap Here and There 

To exchange the primary selection with other text: 

o Make the primary selection finding-delete (hold down I Control I while 
selecting). You don’t have to worry about which item in the swap is 
which. Just pick either one to be the primary selection. 


1 textedit - morning, dirj 

IB 

morning j 

B 

1. Get out of bed. 

D 

3. ^ 

a 



□ Press [ Control-Cop y I while selecting the text to swap. The secondary 
selection is underlined and grayed. 


1 textedit - morning, diri 

IB 

morning 

B 

1. Gfet Otui of 1 

L 


Ib 

3. Brush teeth. I 




□ Release [ Control-Copy 1 . The secondary selection is deleted and placed 
on the Qipboard. The primary selection moves to where the secondary 
selection was. The caret stays where the primary selection used to be. 


I textedit - morning (edi^ 

IB 

morning 

B 

i 

B 



a Press [ Paste l . (This is regular Paste, not secondary Paste.) The text on 
the Clipboard — the former secondary selection — is inserted at the 
caret, completing the swap. 




morning j| 


1. Drink coffee. 

2 . Get out of bed. k 

3. Brush teeth. ^ 
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6.10, Text Handling Table 6-3 contains a comparison of the different ty|:^s of windows with respect 

Comparison to selections, text operations, and related issues. 

Text windows and command windows are similar, since they share the Text 
menu. In general, whatever editing you can do in a text window can also be done 
on the command line in a command window. Whatever is not on the command 
line is normally “read-only,” but you can edit all of the command window if you 
first choose ‘Enable Editing’ from the ‘Cmd Modes=i>’ puU-right menu. 

In tty windows and panels, you can do a subset of text window editing. In these 
windows you can insert or erase text only at the end of the command line or 
panel text item. Certain other restrictions apply, as shown in the table. 

If you choose ‘Services=>Remote Login=>Command Tool’ from the SunView 
menu or type the r login command in a command window, text handling in the 
command line follows the rules for tty windows in Table 6-3. The rest of the 
command window follows the rules for command windows — that is, it’s read¬ 
only unless you choose ‘Enable Editing’. 


Table 6-3 Text Handling in Windows and Panels 



Text Window 

Command Window 

Tty Window 

Panel Text Item 

Insertion point 

Caret 

Caret 

Block cursor 

Caret 

Menu 

Text menu 

Text menu with 
‘Cmd Modes=>’ 

Tty menu 

No 

Select text 

1 or more chars 

1 or more chars 

1 or more chars 

Entire item 

Insert text 

Anywhere 

Anywhere in com¬ 
mand line 

At end of com¬ 
mand line 

At end of item 

Erase text 

Anywhere 

Anywhere in com¬ 
mand line 

From end of com¬ 
mand line 

From end of item 


1 or more chars 

1 or more chars 

1 or more chars 

Entire item 

‘Paste’ 

Anywhere 

Anywhere in com¬ 
mand line 

To end of com¬ 
mand line 

To end of item 

‘Cut’ 

Anywhere 

Anywhere in com¬ 
mand line 

No 

Entire item 


Anywhere 

Anywhere in com¬ 
mand line 

No 

No 

Pending-delete 

selection 

Anywhere 

Anywhere in com¬ 
mand line 

No 

No 

Secondary selec¬ 
tion — source 

1 or more chars 

1 or more chars 

1 or more chars 

Entire item 

Secondary selec¬ 
tion — destination 

Anywhere 

Anywhere in com¬ 
mand line 

End of command 
line 

End of item 
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6.11» Using The get_selection command, which is described in the SunOS Reference 

get_s elect ion Manual, gives you lots of nice ways to work with selections. 

□ To save the selection in a file (especially useful when you want to save part 
of a mail message): 


-- 

Venus % get_selection > filename 


V _■. ' . ...■_____:_^^ 

. J 


Piping is a way of stringing commands together. The pipe symbol is a vertical 
bar (I). The output of the command on the left of the pipe is passed as input to 
the command on the right of the pipe. 

□ To pipe the selection to a print command: 


- ^ 

venus% get_selection | Ipr for printing'^ 

^ • . •• ■ ■ ■ _^___^^■ • •_ J 


□ To pipe the selection to a spelling checker: 







Venus % get__selection | 

1 spell 





J 


□ To use the selection — for example, a directory name — on the command 
line: 


r 


venus% Is -a 'get_^selection' 


V 

J 


The backquotes (' ') mean “not the thing, but the meaning of the thing.” In 
other words, the command line Is -a ' get_select ion ' tells the com¬ 
mand interpreter to evaluate 'get_selection ' before making the list 

NOTE When using get_selection in a command, you mustwait until the command 
completes before making another selection. 

Whenever you type, the current selection is deselected if it’s in the same window. 
Therefore you may lose the selection that you want get_selection to work 
with. You can get around the problem by copying the selection to the Clipboard 
and using it from there. 
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□ To preserve the current selection, copy the selection to the Qipboard by 
pressing i Copy 1 . then type: 
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All About Scrolling 


7.1, Anatomy of the 

Scrollbar 



7.2. Basic Scrolling 

Scrolling Up or Forward 


Often the document you’re editing is too large to be entirely visible within the 
text window. You can resize the window, but most often you’ll want to scroll 
the text through the window. To access parts of the document that aren’t visible, 
you scroll to move the document relative to the window. 

The information about scrolling in text windows in this chapter also applies to 
command windows, panels, and all windows with scrollbars that you’ll encounter 
in this manual and in other SunView manuals. 


At the left of each text window is a gray column called the scrollbar. The light 
gray area is called the bar. 

The bar contains a darker gray area called the bubble. The bubble indicates the 
relative size and location of the the visible text within the document. For exam¬ 
ple, if the bubble is about one-fourth the size of the bar, the document is about 
four windows in length. 

At the top of the scroUbar is a square that contains up/down arrows. It’s known 
as a scroll box. There’s an identical scroll box at the bottom of the scrollbar. 

Both scroll boxes operate the same way; the bottom scroll box is a convenience 
when you’re editing near the lx)ttom of the window. 

The figures in this manual show the default scrollbar. However, you can change 
the appearance of the scroUbar, whether it’s there aU the time, what color it is, 
what side of the window it’s on, how wide or narrow it is, and so on, by changing 
scroUing options in the Defaults Editor. 


Basic scroUing takes place with the pointer in a scroU box. Direct, or advanced, 
scroUing takes place with the pointer in the bar. 


When you move the pointer into the scroU box, its shape changes to a diamond. 

□ To scroU the document up one line, click LEFT in the scroU box. 

The pointer shape changes to an upward-pointing arrow while scroUing, and the 
document moves through the window. 
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The line closest to the start of the document disappears at the top of the window 
and a new line appears at the bottom. 

You can think of this as scrolling forward. 


Scrolling Down or Backward □ To scroll the document down one line, click RIGHT in the scroll tK)x. 

The pointer shape changes to a downward-pointing arrow while scrolling, and the 
document moves through the window. 

The line closest to the end of the document disappears at the bottom of the win¬ 
dow and a new line appears at the top. 

You can think of this as scrolling backward. 


Scrolling a Windowful at a You can scroU at a faster pace by scrolling a windowful at a time. This is some- 

Time times called “paging.” 

□ To scroll up or forward by one windowful, click MIDDLE in a scroll box. 

□ To scroll down or backward by one windowful, hold down the I Shift I key 
while you click MIDDLE in a scroll box. 

Continuous Scrolling By holding down the mouse button instead of clicking and releasing, you can 

automatically repeat any scroll box operation. 

73. Direct Scrolling By clicking the mouse buttons in the bar, rather than in a scroll box, you can 

scroll directly to anywhere in the document. The direction you scroll is con¬ 
trolled by the mouse buttons. 

You can use direct scrolling to move a large distance in the document by thumb¬ 
ing, or to make small adjustments in the window by fine tuning. 


Thumbing in the Bar Thumbing lets you flip to a page in the document as you would flip through a dic¬ 

tionary or telephone book. You use the MIDDLE mouse button for thumbing. 

□ To thumb, click MIDDLE in the bar. 

The actual distance scrolled depends on where you click in the bar. Qick MID¬ 
DLE half-way down in the bar to scroll to the middle of the document, click mid¬ 
dle in the top of the bar to scroll to the start of the document, and so on. 

□ To undo thumbing, click I Shift ) -MlDDLE in the bar. 

When you undo thumbing, the document scrolls to the last click-MIDDLE, the last 
Find that caused a scroll, or the last [ Shift 1 -MlDDLE. whichever is most recent. 

For example, you can thumb to another part of the document, paste or type, and 
undo thumbing to return to the previous location. 

The I Home I and I End! keys (R7 and R13) are another way of scrolling directly. 

I Home I scrolls to the beginning of the document, and [ Endl scrolls to the end. 
However, I Home! and [ End 1 also move the caret, while thumbing leaves the caret 
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I ; 

at its current location. 


Fine Tuning You can use direct scrolling to adjust the placement of text in the window. For 

instance, you may want to see the lines that precede the line at the top of the win¬ 
dow. 

□ To move the line at the top of the window to the pointer, click RIGHT in the 
bar. 

Clicking RIGHT in the bar lets you see preceding lines. The further down in the 
bar you click, the more preceding lines you’ll see. 

□ To move the line opposite the pointer to the top of the window, click LEFT in 
the bar. 

Clicking LEFT in the bar lets you move a line directly to the top of the window 
and exposes more text at the bottom of the window. 

Hold down the 1 Shift I key to fine tune with respect to the bottom of the window. 
This is especially useful when the upper portion of a window is overlapped by 
another frame. 

□ To move the line at the bottom of the window to opposite the pointer, click 

(Shift I -LEFT in the bar. 

.\ 

y □ To move the line opposite the pointer to the bottom of the window, click 

fShim -RlGHT in the bar. 

[ Shift l -LEFT undoes I Shift ) -RIGHT. and vice versa. 
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All About Menus 


This chapter describes all the standard SunView menus: 
o The SimView menu. 

□ The Frame menu. 

□ The Text menu (including command window menu items), 
o The Tty menu. 

The menu items described in the chapter are in the same order as they appear in 
the menus, so you can use the menus themselves as an index to the chapter. 

This section discusses features common to all menus in SunView. 


You can bring up any menu by holding down the RIGHT mouse button. Which 

menu pops up depends on where the pointer is: 

□ The SunView menu pops up when the pointer is over the SunView back¬ 
ground. 

o The Frame menu pops up when the pointer is over any part of the frame 
border. When the pointer is over the frame border, its shaj^ changes to a 
target. 

□ The Text menu jwps up when the pointer is in a text window or a command 
window. 

o The Tty menu pops up when the pointer is in a tty window or a command 
window with scrolling disabled. 

When the menu appears, keep holding down the mouse button until you make a 

choice from the menu or dismiss it. The pointer changes to a right arrow as a 

reminder to move the pointer right to preview puU-right menus. 

□ To choose from a menu, highlight the menu item you want by moving the 
pointer over it; then release the mouse button. 

□ To dismiss a menu without choosing a menu item, move the ix)inter to the 
left so that no menu item is highlighted; then release the mouse button. 
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□ To open a pull-right menu, highlight the puU-right menu item and drag the 
pointer to the right. The puU-iight menu appears. 

Occasionally when you o^n a puU-right menu (say, near the edge of the screen), 
the puU-right menu completely hides its “parent” menu. To get back to the 
parent menu, dismiss the puU-right menu by moving the pointer to the left. If the 
parent menu is only partly hidden, moving the pointer anywhere on the parent 
menu dismisses its “child.” 


Grayed Menu Items If a menu item is displayed in gray — not black — letters, it’s not available to be 

chosen, and it doesn’t highlight when you move the pointer over it. Usually a 

menu item is grayed because it requires a selection and there’s no current selec¬ 
tion. However, a menu item may be grayed for other reasons. For example, 

tools that have not implemented the ‘Props’ menu item in the Frame menu 
display it grayed. 

NOTE Make sure the menu item you want is highlighted before you choose it. If you 

click RIGHT on a grayed menu item, your request is ignored. 


Defaults in Pull-Right Menus To choose the first menu item in a puU-right menu, you don’t have to open the 

menu. That’s because the first item in any puU-right menu is the default for that 

menu. Instead of opening the ‘File=>’ pull-right menu and choosing ‘Save 
Current File’ (the first item), you can simply choose the ‘File=>’ menu item 
itself. In other words, with the standard settings in the Defaults Editor, the 

default for a puU-right menu item is always the fimt item in its menu. This is true 

on all levels of the menu. 

For example, the defaults for the Text menu pull-rights are: 

o ‘File=>Save Current File’. 

□ ‘Edit=^ Again’. 

□ ‘ Display=^»Select Line at Number’. 

o ‘Find=>Find and Replace’ (a pop-up frame). 

□ ‘Extras=>Foraiat’. 

And the defaults in the ‘Find=::>’ pull-right menu are: 

□ ‘Forward’ for the ‘Find=>Find Selection=> menu. 

□ ‘Forward’ for the ‘Fmd=>Fmd Qipboard=>’ menu. 

□ ‘Expand’ for the ‘Find=»Replace l>field<l=>’ menu. 

The nice thing about defaults is that you don’t have to open the pull-right menu 

to choose the default menu item. 

However, if you change the Defaults Editor settings for 
Menu/Initial_Selection and Menu/Def ault_Selection from 
Default to Last_Selection, the default for each pull-right menu 
becomes whatever you last chose from that menu. If that menu choice isn’t 
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Stay-Up Menus 


Menus in Panels 


possible — for example, if it requires a selection and there isn’t one — no action 
is takea 

NOTE Las t_S elections very nice if you’ re earful and experienced, but it can get 

you into real trouble. If you use this option, be sure you know what the default is 
when you choose a pull-right menu without opening it. 


If you get tired of holding the mouse button down while you look at a menu, you 
can change the Me nu / S t a y_up option in the Defaults Editor from F a 1 s e to 
True. Then your menus will appear when you click the RIGHT mouse button 
and disappear when you click it again. With stay-up menus, you click in a 
highlighted menu item to choose it. 


Many panel items have menus associated with them. These work just like the 
standard SunView menus. To bring up a menu in a panel, move the pointer over 
a panel item and hold down the RIGHT mouse button. The current choice in the 
menu may be indicated by a check mark. 
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8.2. The SunView Menu The SunView menu contains tools and services. A tool is a shell, editor, or other 

application that runs in SunView. To request a service, choose its menu item. 

To start a tool, choose its menu item. 

For additional information about tools in the SunView menu, see Chapter 11, A// 
About Tools, and the SunOS Reference Manual. 

The ^Shells=>’ Pull-Right A shell is a window that accepts SunOS commands. The ‘Shells=>’ pull-right 

Menu menu contains menu items for the following SunView shells: 

‘Command Tool’ 

‘SheUTool’ 

‘Graphics Tool’ 

‘Console’ 

To bring up a shell, just choose its menu item. You can have several sheUs open 
at the same time. 


The ‘Editors=>’ Pull-Right The ‘Editors=»’ pull-right menu contains menu items for tools that create and 
Menu revise documents, icons, and fonts, plus a tool that lets you change SunView 

defaults. The following editors are included: 

‘Text Editor’ 

‘Defaults Editor’ 

‘Icon Editor’ 

‘Font Editor’ 


The ‘Tools=>’ Pull-Right 
Menu 


The ‘Tools=>’ puU-right menu contains menu items for additional important 
applications, including: 

‘Mail Tool’ 

‘Dbx (debug) Tool’ 

‘Performance Meter’ 

‘aock=^’ 

You can choose either a round or rectangular clock face from the ‘aock=>’ 
puU-right menu, which contains icons instead of menu-item names. 


The ‘Services=>’ Pull-Right The ‘Services=>’ pull-right menu contains a variety of useful options. 

Menu 

‘Redisplay AH’ Choose ‘Redisplay All’ to refresh the screen. This is useful if the screen image 

appears to have become corrupted. 


‘Printing=>’ The ‘Printing=»’ pull-right menu lets you check the status of print jobs and print 

a selection. 

□ ‘Check Printer Queue’, the default, lists printer status in the Console win¬ 
dow. 


A 
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‘Remote Logm=>’ 


‘Save Layout’ 


The . sunview file. 


‘Lock Screen’ 


‘Exit SunView’ 


□ ‘Print Selected Text’ sends the current selection to the printer. 

NOTE Don’t change the selection until you see the Selection printed message in 

the Console window. 


The ‘Remote Login=»’ pull-right menu lets you bring up a new Command Tool 
or Shell Tool and connect to a remote host. Type the name of the remote host in 
response to the prompt. 


__ . ^ --N 

Hostname? remoteJiost.jiame 

^^ _ ) 


When you’ve finished the session on the remote host, type exit to end the ses¬ 
sion. The Command Tool or Shell Tool quits automatically. 

Choose ‘Services=>Save Layout’ from the SunView menu to save the current 
SunView screen layout in the ~ . sunview file. 

The . sunview file contains the locations of your open and closed frames. 
Whenever you restart SunView, the startup screen is laid out according to the 
. sunview file. For example, if a frame was open when the . sunview file 
was created, it will be opened whenever you start SunView.^ 

If the . sunview file doesn’t exist, the standard startup screen is produced. 

‘Save Layout’ executes the toolplaces command, described in the SunOS 
Reference Manual. 


Choose ‘Lock Screen’ to display a randomly moving Sun logo on a black back¬ 
ground. This prevents the screen from burning in a constant image. Locking the 
screen also provides privacy, since no one can unlock the screen without know¬ 
ing your password. 

To unlock the screen, click any mouse button or press any keyboard key except 
(FI 1 or [ Caps 1 . then type your password and press 1 Return 1 . 


Choose ‘Exit SunView’ to return to the SunOS shell. 

If there’s a serious system problem and you can’t bring up the SunView menu, 
you may be able to “bail out” — this works only if the pointer is over the gray 
background, not over a frame or icon: 

□ Type (Control-Dl followed by (Control-01 for an emergency exit of Sun- 
View. (It’s not a good idea to exit SunView this way unless you have to.) 


® For compatibility with previous releases, if the . sunview file isn’t found, SunView l(X)ks for a 
. suntools file frwn which to restore the screen layout. 
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83. Customizing the 
SunView Menu 

To construct your own SunView menu, you need to: 

□ Constroct a new file containing the menu commands, 

□ Specify the name of the new file to the Defaults Editor. 

□ Exit SunView. 

o Restart SunView. 

When SunView comes up again, you can bring up your new SunView menu. 

After you’ve created the new SunView menu file and restarted SunView, you can 
make additional changes to the file and see them immediately — you don’t have 
to restart SunView again. 


You can modify the SunView menu to add or subtract tools and services. You 
can also display tools in iconic form, the way the ‘Tools=^Clock==>’ puU-right 
menu is displayed. The standard SunView menu is built from the 
/usr/lib/rootmenu file. 


Making a rootmenu File Figure 8-1 shows you the standard SunView menu file. 
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Figure 8-1 SunView Menu File in /usr/lib/rootmenu 


textedit - sunvieuirootmenu, dir: /usr/nutmeg/sages 


e(#)rootmenu 15.7 87/08/19 SMI 
sunviajj root menu 


"Shells" 


"Shells" 
"Editors' 


"Editors' 

"Tools" 


MENU 


'Carmand Tool" 

cmdtool 

•Shell Tool" 

shelItool 

'Graphics Tool" 

gfxtool 

'Console" 

cmdtool -C 

END 

■ MENU 

'Text Editor" 

textedit 

'Defaults Editor" 

defaultsedit 

'Icon Editor" 

iconedit 

'Font Editor" 

fontedit 

' END 

MENU 

'Mail Tool" 

maiItool 

'Dbx (debug) Tool" 

dbxtool 

'Performance Meter" 

MENU 


"Percent CPU Used" 

perfmeter -v cpu 

"Ethernet Packets" 

perfmeter -v pkts 

"Swapped Jobs" 

perfmeter -v swap 

"Disk Transfers" 

perfmeter -v disk 


"Performance Meter" END 

"Clock" MENU 

</usr/include/images/clock.icon) clock 

</usr/include/images/clock.rcOT.icon> clock -r 

"Clock" END 

"Tools" END 

"Services" MENU 

"Redisplay All" REFRESH 

"Printing" MENU 

"Check Printer Queue" sh -c "echo; echo '-echo 

'Printer queue'; Ipq; echo '-■''G" 

"Print Selected Text" sh -c "get_select1on | Ipr ; echo 'Selection 

printed' .-^6" 

END 
MENU 

cmdtool csh -c "echo -n 'Hostname? exec rlogin $< 


"Printing" 

"Remote Login" 

"Cramand Tool' 




$<• 


"Shell Tool" shell tool csh -c "echo -n 'Hostname? exec rlogin 
END 

mv -f ~/.sunview ~/.sunv1eu-;too1places>.sunvieu3; ech 


"Remote Login" 

"Save Layout" sh -c 
0 'Screen layout saved (Previous layout in .sunvieu-) 
"Lock Screen" lockscreen 

"Services" END 

"Exit SunVieu" EXIT 


The name of each menu item is surrounded by double quotation marks ("). Each 
pull-right menu begins with a MENU statement and ends with an END statement. 


NOTE The SunView menu file must not contain any blank lines. Begin an otherwise 

empty line with a pound sign (#). It’s okay to start a line with a Tab character or 
space, as long as the rest of the line isn’t blank. 

For each menu item, supply the name of the menu item in quotes followed by the 
command you want SunView to execute when the menu item is chosen. If the 
command has options, you can specify them right after the command name. 

The command consists of one or more shell commands. Let’s say you have writ¬ 
ten a program called peacenow and you want it to be the default in the ‘Edi- 
tors=>’ pull-right menu. To include your program and its options in the 
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‘Editors=>’ menu, follow these instructions: 

□ Oj^n/usr/lib/rootmenu and add a line before the "Text Edi¬ 
tor" line that looks like this: 





- 


"Peace Tool" 

~/peacenow -make_love -not war 


_ 



J 


o Save the changed file in your home directory as ~ / rootmenu. 

(You can use another filename if you prefer — you have to teE the Defaults 

Editor which name you’re using in any case.) 

□ Bring up the Defaults Editor, cycle to the SunView category, and change the 
RootiTienu_f ilename text item to ~/rootmenu. 

□ Push the Defaults Editor’s Save button to save the change, 
o Exit SunView and restart. 

Now you can open the SunView menu and choose ‘Peace Tool’, which wiE run 
with the options you specified. 


Icons in the SunView Menu The "Clock" MENU definition in Figure 8-1 displays icons, not menu item 

names. You can change the standard SunView menu to display the icons of aE 
the tools it contains, or you can create your own icons using the Icon Editor. 

The standard icons are found in the /usr/ include/images directory. 

To replace a menu item name with its corresponding icon: 

□ List /usr/include/images to find the icon you want (or make your 
own). AE of the filenames ending in . icon are icons. 

□ Replace the menu item name in your SunView menu file (~ / rootmenu, 
described above) with the name of the icon enclosed in <> brackets; for 
example: 

</usr/include/images/textedit.icon> 

□ Save the '/rootmenu file. 

□ Bring up the SunView menu to see the new icon. 
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8.4. The Frame Menu 


‘Close’ and ‘Open’ 


The ‘Move=>’ Pull-Right 
Menu 


The bounding box. 


The Frame menu is used to open or close, move, resize, expose, hide, and 
redisplay frames. It also lets you quit the tool that owns the frame. You can 
bring up the frame menu over an open frame or over an icon. 

□ To bring up the Frame menu, move the pointer over the frame header or any 
other part of the frame border so that the {winter changes to a target. Then 

hold down the right mouse button. 


When you bring up a tool, its frame is open and the Frame menu contains the 
‘Close’ menu item. ‘Qose’ closes the frame to an icon. 

The tool can continue to process while in iconic form. For instance, you can 
compile a program by typing a compiler command in a Command Tool and then 
closing the Command Tool — the compilation continues. 

When the Text Editor is closed, its icon shows the name of the file being edited. 

‘Open’ toggles to ‘Qose’. That is, when the frame is closed, the Frame menu 
you bring up over its icon contains ‘Open’ instead of ‘Close’. 

‘Open’ opens the frame and places it on the screen in the location it occupied 
when you last closed it. ‘Open’does not clear the window. If the tool was inac¬ 
tive while closed, the window looks just the way it did before you closed it. If 
the tool was active, the results of the activity, such as a compilation, are reflected 
in the window. 

Here are the accelerators for ‘Open’ and ‘Close’: 

□ To open an icon using the mouse, move the pointer over the icon and click 
the LEFT mouse button. 

□ To open an icon using a function key, move the pointer over the icon and 
press the (Open I function key. 

□ To close a frame, move the pointer anywhere over the frame (including the 
windows and the frame border) and press (Open I . (The I Open I function key 
toggles to ‘Close’. 


The ‘Move=>’ pull-right menu lets you specify whether the frame moves on one 
axis (constrained) or both (unconstrained). All moving and resizing is done 
using the MIDDLE mouse button. 

When you choose ‘Move=>’, an alert window displays a message that tells you 
how to move the frame or icon. 

When you move or resize a frame, the bounding box — an outline the size and 
shape of the frame — shows you where the frame wiU be located. The bounding 
box moves or changes size as you move the pointer while holding down the MID¬ 
DLE mouse button. When you release the mouse button, the frame moves to the 
location of the bounding box. 

When you hold down the MIDDLE mouse button, the pointer shape changes to 
show you the kind of move or resize you’ve requested — the solid outline 


^sun 

Nr microsystems 


Revision A of 9 May 1988 




134 SxmView 1 Begiimer’s Guide REFERENCE 


‘ Move=^Unconstramed ’ 


‘ Mo ve=>Constrained ’ 


The ‘Resize=»’ Pull-Right 
Menu 


‘Resize=»Unconstrained ’ 


represents the frame and the dotted outline represents the bounding lx)x. The 
pointer shows whether you’re moving or resizing, constrained or unconstrained, 
as described below. 

Choose ‘Move=>Unconstrained’, the default, to move a frame or icon freely on 
the screen. 

Here’s the accelerator equivalent for ‘Move=»Unconstrained’: 

□ Grab the frame border near a corner by moving the pointer over it, then 
holding down the MIDDLE mouse button. Continue to hold down the MIDDLE 
mouse button while you drag the bounding box to the new location. Then 
release the mouse button. 


Choose ‘Move=>Constrained’ to move a frame or icon in only one direction — 
left-and-right or up-and-down, but not both. If you want frames precisely lined 
up, it’s helpful to constrain the move. 

Here’s the accelerator for ‘Move=>Constrained’: 

□ Grab the frame border near the middle of a side by moving the pointer over 
it, then holding down the MIDDLE mouse button. Continue to hold down the 
MIDDLE mouse button while you drag the bounding box to the new location. 
Then release the mouse button. 


The ‘Resize=>’ pull-right menu lets you change the dimensions of a frame. 

When you choose ‘Resize=>’, an alert window appears with instructions for you 
to foUow. The bounding box shows you the new shape before you release the 
mouse button. 

‘Resize=>’ is only for frames. You can’t change the size of an icon. 


Choose ‘Resize=>Unconstrained’, the default, to resize a frame freely, changing 
both dimensions at once, by grabbing near a comer of the frame. The comer you 
grab moves, and the opposite comer remains fixed. For example, to make a 
square frame into a smaller square, move the pointer diagonally from any comer 
of the frame toward the opposite comer. 

The accelerator equivalent for ‘Resize=:>Unconstrained’ is: 

□ Hold down the (Control 1 key. 

□ While holding down the MIDDLE mouse button, grab the frame border near 
the corner you want to stretch or squeeze, and move the pointer toward or 
away from the opposite comer. 

□ Release the mouse button and the f Control 1 key when the bounding box 
location is satisfactory. 
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‘ Resize==»Constrained ’ 


Choose ‘Resize=»Constrained’ to resize one dimension of a frame by grabbing 
near the middle of a side of the frame. The side you’re grabbing moves, while 
the opjx)site side remains fixed. You can change either the height or the width 
while holding the other constant. 

The accelerator for ‘Resize=>Constrained’ is: 

o Hold down the f Control) key. 

□ While holding down the MIDDLE mouse button, grab the frame border in the 
middle of the side you want to stretch or squeeze, and move the pointer 
toward or away from the opposite side. 

□ Release the mouse button and the f ControTI key when the lx)unding tox 
location is satisfactory. 

A special use for the ‘Resize=^Constrained’ accelerator is to enlarge the Text 

Editor’s scratch window. This can only te done using an accelerator — it 

doesn’t work from the Frame menu because that resizes frames, not windows. 

Resizing lets you keep more temfwrary information visible than you can fit in the 

single line of a standard scratch window. You could use the Defaults Editor to 
change the Text/Scratch__window default, but that change wouldn’t be 
immediate, and aJl subsequent Text Editor frames would reflect the change. 

To resize a Text Editor scratch window: 

□ Move the pointer to the horizontal space between the edit window and the 
scratch window. The space between the windows is actually part of the 
frame — you can teU by the way the pointer changes to a target. 

□ Hold down the (Control j key. 

□ Hold down the middle mouse button while dragging downward until the 
Text Editor frame looks like Figure 8-2. Then release the fControl i key and 
the mouse button. 
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‘Resize=^Zoom’ and 
‘ Resize=>UnZoom ’ 


‘Resize=>FullScreen’ 


Figure 8-2 The Scratch Window Resized 



Choose ‘Resize=>Zoom’ to resize a frame to the full height of the screen. When 
you have zoomed a frame, the menu item toggles to ‘UnZoom’, which 
remembers the former location of the frame. ‘Zoom’ and ‘UnZoom’ are handy 
when you want to list a large directory in a Command Tool, look at it briefly, and 
then restore the Command Tool frame to its former size. 

‘UnZoom’ also restores a frame that was enlarged by ‘Resize=>FullScreen’. 

Here are accelerators for ‘Zoom’ and ‘UnZoom’: 

□ To zoom a frame, move the pointer over the frame border. The pointer 
shape changes to a target. 

□ Hold down the (Control ] key while clicking the LEFT mouse button. The 
frame zooms to full height. 

o To restore a zoomed frame to its original size and location, foUow the same 
procedure: Qick [ Control 1 -LEFT with the pointer on the frame border. 


‘FuUScreen’ enlarges a frame so that it occupies tlie entire screen. To restore the 
frame to its fomer size, choose ‘Resize=>UnZoom’ or use the Zoom/UnZoom 
accelerator. 
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Think of the frames on a screen as sheets of paper on a horizontal surface, hke a 
desk. Some of the sheets overlap. Now imagine rotating the surface ninety 
degrees so that it’s standing up, like a screen. The overlapping sheets or frames 
that were on top are in front; those that were on the bottom are in back. 

‘Front’ changes the overlap by exposing a frame, bringing it forward, in front of 
other frames. The frame from whose Frame menu you choose ‘Front’ is tlie 
frame that is acted upon. ‘Front’ and ‘Back’ also work on icons. 

An accelerator equivalent for the ‘Front’ menu item is: 

o Move the pointer anywhere over the frame you want to bring forward. 

o Press the (Front I function key. 

‘Back’ ‘Back’ changes the overlap by hiding a frame, sending it in back of other frames. 

The frame from whose Frame menu you choose ‘Back’ is the frame that is acted 
upon. 

It’s possible to have a frame that’s in front of one frame and in back of another. 
In Figure 8-3, the Text Editor frame is in front of the Console frame and in back 
of the Command Tool frame. If you choose ‘Back’ from the Command Tool’s 
Frame menu, the Text Editor frame will overlap the Command Tool frame but 
remain in front of the Console frame. If you choose ‘Back’ from the Text 
Editor’s Frame menu, on the other hand, the Text Editor frame wiU be over¬ 
lapped by both other frames. 


‘Front’ 



^sun 

microsystems 


Revision A of 9 May 1988 






138 SunView 1 Beginner’s Guide REFERENCE 


‘Props’ 


‘Redisplay’ 


‘Quit’ 


Figure 8-3 Overlapping Frames 
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cmdtool - /bin/csh 
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Choose ‘Props’ to bring up a property sheet that lets you set options for the tool. 
‘Props’ is currently grayed — not available for use — in most SunView tools. 

‘Redisplay’ redraws the frame and its contents. It’s needed only when the screen 
image seems to have become corrupted. 

You can also redraw the entire screen by choosing ‘Services=>Redisplay All’ 
from the SunView menu. 


‘Quit’ sends away the tool that owns the frame. No icon remains. To start the 
tool again, choose it from the SunView menu or type its name in a shell com¬ 
mand. 

An alert message asks you to confirm that you really want to quit. 
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8.5. The Text Menu 


8.6. The ‘File=:^^ Pull-Eight 

Menu 


‘Save Current File’ 


Backup Files 


Remember to Save Frequently 


‘Store as Nevr File’ 


You can bring up a Text menu in any text window or command window. Some 
windows have limits on the features you can use, and others have special 
features. For example, you can’t use ‘Load File’ in a scratch window, and you 
get an extra pull-right menu, ‘Cmd Modes=>’, in a command window. The stan¬ 
dard Text menu pull-right menus are ‘File=>’, ‘Edit=>’, ‘Display=>’, ‘Find=»’, 
and ‘Extras=>’, plus ‘Cmd Modes=>’ in command windows. 


The ‘File=>’ pull-right menu contains commands for saving and retrieving files, 

setting the directory, starting a new document, plus some fast ways to end a work 
session. 


When you’re ready to save your work, bring up the Text menu and choose 
‘File=»Save Current File’. This saves the document in the window under the 
filename that appears in the frame header. If the frame header says (NONE), 
there’s no current file — type the new filename, select it, and choose ‘File=>Store 
as New File’ instead. The new filename can be in any window. 


Each time the Text Editor does a save or store, it first copies the old version of 
the file to a file named f ilename%. The percent sign (%) means this file was 

created as a backup file. The backup file is saved in the current directory. 

The next time you save or store, the Text Editor replaces f ilename% before it 
saves the new filename. Backups are automatic. You simply continue edit¬ 
ing. 

Backup files don’t go away until you delete them. 

When you have been working in the Text Editor for a long time, the internal data 
stractures may become fragmented so that you notice a degradation in perfor¬ 
mance. Save the document you’re working on, and performance will return to 
normal. 

Frequent saving is probably a good idea in any case — if the system crashes, the 
edits you made since the last Store or Save will be lost. 

If you’d rather have SimView do the saving, you can use the Defaults Editor to 
request checkpointing. Change the Checkpoint_f requency default line in 
the Text category from its default of 0 to a positive integer n. This causes a 
checkpoint file to be written every n edits. The name of the checkpoint file is the 
name of the file you’re editing with the suffix %% added. See Chapter 10, The 
Defaults Editor, for instructions on how to change a default. 


This menu item lets you create a new file. If the filename you select is the name 
of an existing file, an alert window gives you a warning message. 

To store a document in the window as a new file: 

o Select the filename in any window. You may have to type it, in which case 
the Text Editor’s scratch window is a handy place to do that. 
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^Load File’ 


‘Include File’ 


‘Set Directory’ 


□ Choose ‘File=:>Store as New File’. The document is stored to the selected 
filename in the current directory (shown in the frame header). 

To store a document in a different directory, select the absolute or relative path¬ 
name of the file. For example, /home/novels/great___american is an 
absolute pathname; . . /comedies_and_tragedies is a relative pathname. 


To load a file in the Text Editor: 

□ Select the filename in any window. If it’s not in the current directory, 
choose ‘File=>Set Directory’ first or specify the full pathname. 

□ Choose ‘File=>Load File’. 

The frame header shows the new filename. 

Here’s an accelerated way to load a file: 

□ Move the pointer into the text window where you want the file loaded. 

□ Type the filename by itself on the first line in the text window. 

o Press the 1 Esc I key. The file is loaded into the text window. 

See ‘Set Directory’ in this chapter for a way to use ‘Load File’ to set the direc¬ 
tory. 


‘Include File’ lets you put a file in a text window at the insertion point. The 
filename in the frame header doesn’t change. You can include many files in a 
single document and then save the document as a new file. 

To include a file: 

□ Set the insertion point where you want the file to go. 

□ Select the filename in any window. 

□ Choose ‘File=>Include File’. The file appears at the insertion point and the 
window scrolls to the end of the inserted file. 

Here’s an accelerated way to include a file in the middle of a document: 

o Move the pointer into the text window where you want the file included. 

□ Type the filename by itself on the line where you want the file inserted. 

□ Press (Shift-Esc) . 

The file is inserted into the text window, replacing its name. 


The current directory for the Text Editor appears on the right side of the frame 
header. The default is your working directory. 

To change the current directory: 

□ In any window, select the name of the new directory. Type it fimt if you 
need to. 
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‘Empty Document’ 


‘Finishing Up=»’ 


□ Move the pointer into the edit window and bring up the Text menu. Make 

sure the pointer is in the edit window, not the scratch window. 

□ Choose ‘File=>Set Directory’. 

The new directory name appears in the frame header. 

‘Set Directory’ follows the same rules as the SunOS cd (change directory) com¬ 
mand. For example, if you’re in your home directory, 
/cinammon/nutmeg/sage, and you want to change the directory to 
/cinammon/nutmeg/sage/par s ley, select the word parsley and 
choose ‘Set Directory’. You can change back to your home directory by select¬ 
ing . . or ~ and choosing ‘Set Directory’ again. 

There are two accelerators for ‘File=^Set Directory’; [ Esc 1 and ‘File=^Load 

File’: 

a To set the directory using the fEscl key, type the directory name by itself on 
the firet line in the window, then press I Esc 1 . 

□ Select the directory name in any window, then move the pointer into the edit 
window whose directory you want to change and choose ‘Load File’. The 
directory is changed and the new directory appears in the frame header. 

To set the directory using ‘Load File’, you must first change the Defaults 
Editor setting for Text/Load_file_of_directory from Is_error 
to Is_set_directory, then bring up a new Text Editor frame. 


Sometimes you’re editing an existing file and you want to start a brand-new 
document. The way to do that is to save the file you’re working on and then ask 
for an empty document — a text window with no text in it and no filename asso¬ 
ciated with it. 

To empty the text window: 

□ Choose ‘File=»Empty Document’. The filename is changed to (NONE). 

If you haven’t saved your most recent edits in that window, you’U receive an 
alert message asking if you really mean to discard them. 

Getting an empty document is just like bringing up a new Text Editor. You can 
create a new document from scratch. When you save it for the first time, you’U 
have to choose ‘Store as New File’ because there isn’t a current file yet. 

The ‘Finishing Up=>’ puU-right menu lets you specify a combination of Save or 
Store together with another action. 

The menu items are: 

□ ‘ Qose, then Save Current File’ 

□ ‘Save Current File, then Quit’ 

□ ‘ Save, then Empty Document’ 
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The ^Edlt=^’ 
Eight Menu 

^Agaie’ 


Again Ignores Undo 


□ ‘Qose, then Store as New File’ 

□ ‘Store as New File, then Quit’ 

The combinations that include ’Store as New File’ require a selection. 

Pull“ The ‘Edit=>’ pull-right menu contains commands for copying and inserting text, 

undoing editing, and repeating commands. 


‘Edit=>Again’, the default, executes all of the operations that you f^rformed in a 
text window since the last time you changed the insertion point. 

The accelerators for ‘Edit=»Again’ are the I Again 1 function key and I ♦-AI . 

Scrolling the display has no effect on ‘Again.’ 

With ‘Again’, you can repeat the same series of commands at several places in a 
document. For example, you can choose ‘Again’ to repeatedly insert beginning 
and ending brackets around text. (‘Insert Brackets=^’ in the ‘Extras=>’ puU-right 
menu inserts some frequently used bracket pairs. The technique shown below 
lets you insert any brackets.) To insert brackets around a selection using 
‘Again’: 

o Select the first item — say, First Example. 

□ Choose ‘Cut’ to delete the item and store it on the Clipboard. 

□ Type the beginning bracket, say / (the opening comment delimiter in C 
programs). 

□ Choose ‘Paste’ to retrieve the deleted text from the Qipboard. 

□ Type the ending bracket, say * / (the closing comment delimiter in C pro¬ 
grams). The result is /*FirSt Example*/. 

□ Select the second item. 

□ Choose ‘Again’ to bracket the second item. 

□ Select the third item and choose ‘Again’. 

And so on... Note that the text you bracket doesn’t have to be the same in each 
case. For example, you can use ‘Again’ to bracket Second Example, Third 
Example, and so on. 


One convenient use of ‘Again’ is to correct the error of inserting text at the 
wrong place. Just choose ‘Undo=>’, move the insertion point to the correct posi¬ 
tion, then choose ‘Again’. 

NOTE Edits performed in one text window have no effect on the operation of ‘Again’ in 
another text window. 
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Again and Find 


You can use ‘Again’ in conjunction with ‘Find’ to search through a document, 
finding and replacing text. ‘Find’ is one of the operations that ‘Again’ repeats 
because, although ‘Find’ changes the insertion point, it does so without a mouse 
action. 

‘Again’ with ‘Find’ is useful when you want to search for special characters like 
Tab and Return that the Find and Replace frame doesn’t handle. 

For example, you can indent a series of lines by searching for the Return charac¬ 
ter in the first line, replacing it by pressing (Return I followed by I Tab I . then 
choosing ‘Again’ for each additional line to be indented. 

Wlien ‘Find’ doesn’t find matching text, the rest of the operations that ‘Again’ is 
repeating are not executed. 

Here’s an example combining f Again 1 with f Find ) . keyboard control of the caret, 
and erase accelerators (described in Chapter 9, All About Accelerators). You’ll 
be able to adapt the techniques shown here to automate previously tedious 
search-and-replace operations by setting up a model and repeating it almost 
effortlessly with ‘Again’. 

The example edits a document on women’s suffrage containing the phrases 
many women should vote, some women should vote, and most 
women should vote, changing all of these phrases to all women 
should vote; 

□ Select the word women in the first phrase and press (Copy I to put it on the 
Clipboard. 


textedit - suffragettes, dir: /home/nutmeg/sages 


f4ll n so lidarity with Elizabeth Cady Stanton, we declare that many 
IBMBI should vote. . 

urely it is only just that some women should vote. ' 

In fact we believe it is for the good of the nation that most 
wonen should vote. 


□ Press the (Find 1 fimction key to select the next occurrence of women in the 
document. 


g 



__.. .:j| 


In solidarity with Elizabeth Cady Stanton, we declare that many 


women should vote. 


Surely it is only just that some fttSiiTgi^ should vote. 

In fact we believe it is for the go^of the nation that most^ 


wcNmen should vote. 
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° (Find I puts the caret at the end of the word, so press t Control-^mOTa 1 to 

move the caret in front of the w. 




1! 

p 

In solidarity with Elizabeth Cady Stanton, we declare that many 
women should vote. 

Surely it is only just that some should vote. ^ 

In fact we believe it is for the good of the nation that most 
women should vote. 


□ Press (Control-W 1 to erase the previous word— some, many, or most. 
The space is erased also. 




;. ..... , 

4iL 

In solidarity with Elizabeth Cady Stanton, we declare that many 
woTien should vote. 

Surely it is only just that women should vote. k 

In fact we believe it is fo* the good of the nation that most ^ 
women should vote. 


o Type all followed by a space to replace the word you erased. 



textedit - suffragettes (edited), dir: /home/nutmeg/sages 


In solidarity with Elizabeth Cady Stanton, we declare that many 
Iwcmen should vote. 

Surely it is only just that all women should vote. k 

In fact we believe it is for th* good of the nation that most ^ 

1 women should vote. 


□ Press f Shift-Control-com?^ to move past women in the phrase you just 

changed, so that fFindl won’t find the same word again. 


textedit - suffrage;ttes (edited), dir: /home/nutmeg/sa 




In solidarity with Elizabeth Cady Stanton, we declare that many 
women should vote. 

Surely it is only just that all women should vote. k 
In fact we believe it is for the good of the nation that most ^ 
wcmen should vote. 
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‘Uiido=>’ 


‘Undo Last Edit’ 


‘Undo All Edits’ 


‘Copy’, ‘Paste’, and ‘Cut’ 


□ Now press the (Again 1 function key to repeat the entire series of operations. 
Keep pressing I Again I until no more women can be found to enfranchise. 



|£ 



In solidarity with Elizabeth Cady Stanton, uie declare that all 

ft 

ucmen should vote. 

Surely it is only just that all women should vote. ^ 

\ 

In fact we believe it is for the good of the nation that all 

g 

WOTien should vote. 


The ‘Undo=>’ pull-right menu lets you undo the last edit you made, or all edits 
since the last ‘Save’ or ‘Store as New File’. 


‘Undo Last Edit’, the default, undoes the effect of the most recent editing opera¬ 
tion: ‘ Cut’, ‘Paste ’, or typing. 

The accelerators for ‘Undo Last Edit’ are the (Undo I function key and I #-UI . 

The range of ‘Undo Last Edit’ goes back to the last time you clicked LEFT to 
change the insertion point. If the most recent edit was the only one since the last 
‘Save’ or ‘Store as New File’, the (edited) signal is removed from the frame 
header. 

You can choose ‘Undo Last Edit’ repeatedly to undo a series of edits. 


The range of ‘Undo AU Edits’ goes back to the last time you saved or stored the 
document. You can think of ‘Undo AU Edits’ as the equivalent of ‘Empty Docu¬ 
ment’ plus ’Load File’ to reload the last saved version. 

‘Undo All Edits’ can rescue you, for example, when you push the Replace All 
button in the Find and Replace frame, then change your mind. Hint: You need 
to have chosen ‘Save’ or ‘Store as New File’ just before the replacement, which 
is always a good idea. 

‘Copy’, ‘Paste’, and ‘Cut’ aU work with the Clipboard, a buffer shared by aU 
frames. 

o ‘Copy’ places the selection on the Clipboard. Its accelerators are the I Copy I 
function key and ( #-C I . 

□ ‘Paste’ places the contents of the Clipboard at the insertion point. Its 
accelerators are the (Paste 1 function key and ( #-¥ 1 . 

□ ‘Cut’deletes the selection and places it on the Qipboard. Its accelerators 
are the (Cut) function key and I ♦-X1 ‘Paste’ undoes ‘Cut’ as long as you 
don’t move the caret. 
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‘Show Clipboard=>’ ‘Show Qiplx)ard=>’ is a pull-right menu whose menu item consists of the current 

contents of the Qipboard. 

If the selection on the Clipboard is long, only the first several characters are 
shown. 

For convenience, ‘Show Qipboard=»’ also appears in the ‘Find=>’ pull-right 
menu. 

‘Copy then Paste’ ‘Copy then Paste’ gives you two operations for the price of one menu item. 

When the active caret is not with the selection — for example, when you make a 
selection and then move the keyboard focus to another window ‘Copy then 
Paste’ copies the selection to the caret. 

In a command window, you can also use this handy combination to copy a previ¬ 
ous command to the command line in order to edit it or execute it again. That’s 
because the caret stays on the command line when you select text in the tran¬ 
script (unless you’ve selected ‘Enable Editing’). 

An accelerator for ‘Copy then Paste’ is f ♦-?) . It works like ‘Stuff in the Tty 
menu. Some people think ( ♦-P1 is the most useful accelerator there is. 


8.8. The ‘Display=>’ Pull- The ‘Display=>’ pull-right menu provides commands for changing the text 
Right Menu display. You can scroll to the text that contains the caret; move the caret to the 

top or bottom of the document and scroU there; split the window into scrollable 
sections; and change the way text wraps at the right window edge. 

‘Select Line at Number’ ‘Select Line at Number’, the default, scrolls the document so that the line whose 

number you specify shows in the window. This menu item requires a selection 
containing the line number you want. 

A quick way to correct errors in a compilation is to use two windows. One con¬ 
tains the source program, the other contains the error listing. Starting from the 
last error shown, so that you won’t change earlier line numbers when you make 
corrections: 

o In the error-listing window, select the number of a line containing an error. 

□ In the source-program window, choose ‘Select Line at Number’. The line 
scrolls into view. 

□ Correct the error in the source listing. 

□ In the error-listing window, select the next numter, and so on. 

‘What Line Number?’ ‘What Line Number?’ is a request for the line number of the line that contains 

the selection or the beginning of a multi-line selection. An alert window appears, 
telling you the line number. Push the Continue button after you’ve read the alert 
message. 

‘Select Line at Number’ and ‘What Line Number?’ refer to the physical line 
number — where a line is the amount of text tetween Line Feed or Return 
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‘Split View’ 


Many views, one caret. 


Why Split a View? 


characters. Therefore the line number changes only if you add or delete a Line 
Feed or Return, not if you merely change the line wrap or the window width. 

You can split a text window or command window into an (almost) infinite 
number of sections and scroll each one independently. Each section is known as 
a view. Before you split it, the view consists of the entire window. 

A window contains only one caret, representing the insertion point, no matter 
how many views you have. 

To split a view: 

□ Move the pointer into the view. 

□ Bring up the Text menu and choose ‘Display=»Split View’. An alert win¬ 
dow appears: 


Figure 8-4 Split View Alert Window 



Move pointer to where new view should 
begin^ then click the left mouse button. 

Otherwise, push "Cancel Split View". 
[Cancel^Split View] 



□ Click LEFT anywhere in the view. A horizontal line apj^ars, splitting the 
view at the point where you clicked. 


Split views come in really handy. Here are examples from two different tools. 
As you work with text windows, you’ll probably find additional uses. 
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□ In a Command Tool, you can list the contents of a directory, then split the 
view so that you can continue to see the directory listing in the top view as 
you type commands in the bottom view. 


Figure 8-5 Split View in Command Tool 
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‘Destroy View’ 


‘Show Caret at Top’ 


‘Move Caret to Start 


o In an edit window in the Text Editor, you can load an outline of a document, 
duplicate it in the window, then split the view so you can continue to see the 
outline in the top view while writing the sections in the bottom view. 


Figure 8-6 Split View in Text Editor 


textedit - (NONE), dir: /usr/nutmeg/sages 


t Scratch window 

_ A 





HOW TO RETIRE IN FIVE YEARS 

A. Join a Silicon Valley startup. 

B. Work 90 hours a week. 

C. Eat at Macdonald's. 

D. Save money in my mattress. 

E. Exercise stock options when company 

goes public. 

F. Buy land in Lesser Antilles. 

HOW TO RETIRE IN FIVE YEARS 


Work 90 hours a week: 

1. Take lots of vitamins. 

2. Get a massage every week. 

3. Get up early and jog or swim. 

4. Turn off my telephone and tell 
my friends I've left town. 

5. Find a comfortable chair for my office 

6. Chant affirmations for success. 


To unsplit a view: 

o Move the pointer into either half of the split view, 
o Bring up the Text menu and choose ‘Display=»Destroy View’. 


‘Show Caret at Top’ moves the line containing the insertion point to the top of 
the window. This is a good way to retrieve a “lost caret” when you’ve been 
scrolling through history in a Command Tool. 


‘Move Caret to Start’ moves the caret in front of the first character in the docu¬ 
ment and displays it at the top of the window. Sometimes it’s helpful to do this 
before beginning a find and replace operation. 

NOTE ‘Move Caret to Start’ and ‘Move Caret to End’ do not affect the current selec¬ 
tion, even though it may no longer be visible in the window. You can inadver¬ 
tently delete or change a pending-delete selection by assuming that you’re work¬ 
ing at the caret. 
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‘Move Caret to End’ 


‘Change Line Wrap=^’ 


‘Wrap at Character’ 


‘Wrap at Word’ 


‘Clip Lines’ 


8,9, The Pull- 

Right Menu 


The Find and Replace Frame 


Accelerators for ‘Move Caret to Start’ are 1 Home 1 (R7) and 
(Shift-Control-Retimn . 


‘Move Caret to End’ moves the caret to the end of the last line in the document 
and displays it at the bottom of the window. This is a good way to get to the end 
of a text window when you want to type or include more text. 

Accelerators for ‘Move Caret to End’ are f Eiidl (R13) and \ Control-Return 1 . 


The ‘Change Line Wrap’ pull-right menu lets you change the way physical lines 
are displayed in a window. 

Wrapping means that the portion of a line that extends past the right edge of the 
window flows to the next line in the window, starting at the left. 

‘Wrap at Character’, the default, causes characters that do not fit on a line in the 
window to wrap around to the following window line. A single physical line 
may be wrapped onto several window lines, depending on the width of the win¬ 
dow. 


‘Wrap at Word’ operates like ‘Wrap at Character’ with words rather than charac¬ 
ters as the basic unit. In most text windows, ‘Wrap at Word’ is a lot easier on the 
eyes — but remember that the actual length of physical lines may be obscured, 
so you may get strange results when you print the text. In Command Tool, you 
may prefer ‘Wrap at Character’ when reading long command lines. 


When you don’t want wrapping of long lines, choose ‘Change Line Wrap=>aip 
Lines’. This menu item causes characters that do not fit on the line to “disap¬ 
pear” on the right side of the window — they’re still there, but you can’t see 
them. 

To wrap the lines in the document again, choose ‘Wrap at Character’ or ‘Wrap at 
Word’. 

You can permanently divide long lines into shorter ones by piping the text 
through the f mt command. To do this, select the text to be formatted, make it 
pending-delete, and choose ‘Format’ from the ‘Extras=>’ puU-right menu. 


The ‘Find=>’ pull-right menu offers many ways to find and replace text. This 
menu includes two menu items that bring up pop-up frames for specialized Find 
operations. 


Choose ‘Find and Replace’, the default, to bring up the Find and Replace pop¬ 
up frame, shown in Figure 8-7. An accelerator to bring up the frame is 
(Control-Find 1 . In the Find: and Replace: panel text items, type or paste the text 
you want to find and the text to replace it, then push panel buttons to do the 
work. 
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Figure 8-7 The Find and Replace Frame 


Find and Replace 


Done 


^fteplace] : 

iMndthen Replace] [Replace then Find] [Replace A1 1) 


3 


CAll Text 
[Blink Ouner] 



The AH Text cycle item. 



When searched-fortext is found, the text is selected and the window is scrolled 
to display it. 

□ The Find: text item contains the text you want to search for. As with other 
panel text items, you can select or delete the entire text item, or backspace 
from the end of it, but you can’t do more complex editing. 

If there’s a current selection when you bring up the Find and Replace frame, the 

selection is inserted in the Find: text item automatically. 

When you push the Find button, a search begins at the caret and the next 
occurrence of the Find: text item is selected. 

If there’s no match, the owner frame blinks and beeps. 

The Find button searches forward by default, but if instead of clicking LEFT you 

hold down RIGHT, you’ll see a menu that lets you set the direction to ‘Backward’ 

instead. You can also search backward bv pressing f.SHTftl -Find. The f Shift I kev 

often reverees the direction of an action in SunView. 

□ The Replace: text item contains the text you want to use as a replacement 

for the found selection. Push the Replace button to replace the selection. 

□ Push the Find thee Replace button to find and immediately replace the next 
occurrence. If you goofed, you can choose ‘Edit=>Undo’ to correct the mis¬ 
take. 

□ Push the Replace thee Find button to replace the found selection and 
immediately find the next occurrence. 

□ Push the Replace All button to change every occurrence in the document. 

It’s a good idea to save or store just before you do this, in case the results are 
different from what you expected. 

The cycle item is set to All Text. This means that no matter where the caret is 
when you begin searching, the search doesn’t stop at the end of the document but 
wraps around to the top and continues back to the caret. If you want the search to 
stop at the end of the document, click LEFT on the cycle item to set it to To End. 

Pushing the Blink Owner button blinks the owner’s frame to show you where it 
is, in case you have more than one open text window or command window. 

The Done button closes the Find and Replace frame. You can leave it open, 

though, and use it to search for different text. When you close the owner frame, 

the pop-up frame closes too. 
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Tind Selection==>’ 


‘Find CIIpboard=>’ 


Accelerator for 'Find=>’. 


‘Show CIipboard=>’ 


The Find Marked Text Frame 


Figure 8-8 


Choose ‘Find Selection=>’ to search from the caret and select the next occurrence 
of the current selection. The default direction is forward, but you can choose 
‘Find Selection=>Backward’. 


Choose ‘Find Qipboard=>’ to search from the caret and select the next 
occurrence of the Clipboard contents. The default direction is forward, but you 
can choose ‘Find Cliplx)ard=>Backward\ 

The I Find 1 function key acts as an accelerator. Here’s how it works. 

□ If there’s a selection, 1 Find I is the equivalent of ‘Find Selection=»Forward’ 
and I Shift-Find I is the equivalent of ‘Find Selection=>Backward’. 

□ If there’s no selection, (Find 1 is the equivalent of ‘Find 
Clipboard=>Forward’ and f Shift-Findl is the equivalent of ‘Find 
Clipboard=>Backward ’. 

□ If you make a secondary selection by holding down the f Find 1 key while 
selecting text, the secondary selection is searched for when you release the 
function key. The search is in a forward direction, but you can reverse it by 
holding down 1 Shift-Find) while making the secondary selection. This is a 
handy way to search without changing the Clipboard or the current primary 
selection. 


Highlight ‘Show Qipboard=»’ and pull right to see the current contents of the 

Clipboard. 

For convenience, this menu item appears in both the ‘File=>’ and ‘Edit=>’ pull- 
right menus. A more complete description is found under Section 8.7, The 
‘Edit=>’ Pull-Right Menu. 


Choose ‘Find Marked Text’ to search for text bounded by certain delimiters. 
‘Find Marked Text’ brings up the Find Marked Text pop-up frame, shown in 
Figure 8-8. 


The Find Marked Text Frame 



llBackward] [ Expand ] [ Forujard | 

fSlink OSn'erq f Done “} 

|q ( ) a " - o ^ 

0{} Q[] Q|><| Q/**/ 


There’s a choice button to the left of each delimiter pair in the Find Marked 
Text frame. The pairs are \ } r i ], 

I > < 1, and / * * /. Click LEFT on the choice button to indicate which pair to 
search for. The choice button highlights. Then push Forward or Backward to 
search in the requested direction. The next occurrence of text within the 
requested delimiters is highlighted. 
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The Expand button finds the next outer pair of the specified delimiters, searching 
in both directions from the caret. 

The Blink Owner and Done buttons work just as they do in the Find and 
Replace frame. 


‘Match Delimiter’ Select a delimiter, then choose ‘Match Delimiter’ to find the matching end of the 

delimiter pair. The delimiters and the text between them are selected. The del¬ 
imiters recognized by ‘Match Delimiter’ are the same as those displayed in the 
Find Marked Text frame. 

If the beginning and ending delimiters differ, like open bracket and close bracket 
([ and ]), ‘Match Delimiter’ searches forward if the selection is a beginning del¬ 
imiter and backward if the selection is an ending delimiter. If there’s no differ¬ 
ence, ‘Match Delimiter’ searches forward. 

‘Replace |>field<|=>’ Choose ‘Replace l>field<l=>’ to find a field and select it as pending-delete. The 

search begins at the caret. Afield is any text between l> and <1 delimiters. 

‘Expand’, the default, searches in both directions, expecting the caret to be 
within a delimiter pair. 

‘Next’ searches forward from the caret. An accelerator for ‘Replace 
l>field<l=>Next’ is i Control-Tab I . 

‘Previous’ searches backward from the caret. An accelerator for ‘Replace 
l>field<l=»Previous’ is (Shift-Control-Tab 1 . 


8.10. The ‘Extras=»’ Pull- The ‘Extras=»’ pull-right menu contains some useful formatting commands. The 
Right Menu menu gives you a way to use text filters without having to map them to keys. 

When you make a selection and choose an ‘Extras=>’ menu item, the selection 
becomes the standard input (stdin), and the resulting standard output 
(stdout) is inserted at the caret. If the selection was pending-delete, the stan¬ 
dard output replaces the selection. For more information on the standard input 
and the standard output, see Doing More with SunOS: Beginner’s Guide. 


‘Format’ ‘Format’ uses the fmt command to reformat long lines of text. 

Make a pending-delete selection, then choose ‘Format’ to format the lines in the 
selection with a line length that can be printed and viewed more easily. 

NOTE To make a selection pending-delete, hold down the I Control I key while making 
the selection. 

The fmt command divides text into physical lines of not more than 72 charac¬ 
ters; it does not split words between lines. See the fmt command in the SunOS 
Reference Manual for more information. 
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Tretty-print C’ 


‘Capitalize=>^ 


‘abcd->ABCD’ 


‘ABCD->abcd’ 


‘abcd->Abcd’ 


‘Shift Liiies=>’ 


‘Insert Brackets=>’ 


‘Remove Brackets=>’ 


8»11» Customizing 1 
‘Extras=»’ Mi 


Tretty-print C’ uses the indent command to format C program listings. It for¬ 
mats the selection according to standard specifications. If you have a 
. indent. pro file, the selection is formatted according to the specifications in 
the file. For more information on formatting source programs written in C, refer 
to the indent command in the SunOS Reference Manual. 

The ‘Capitalize=>’ puU-right menu gives you three choices for changing the capi¬ 
talization of a selection. 

NOTE Make the selection pending-delete before choosing from the ‘Capitalizes^' pull- 
right menu in order to replace the selection with the newly capitalized version. 


Choose ‘Capitalize=»abcd->ABCD’ to change all the letters in the pending- 
delete selection to upper case. 


Choose ‘Capitalize=>ABCD->abcd’ to change all the letters in the pending- 
delete selection to lower case. 

Choose ‘Capitalize=>abcd->Abcd’ to change the first letter of every word in the 
pending-delete selection to upper case. Upper-case letters within a word are not 
changed. 


The ‘Shift Lines=>’ pull-right menu lets you insert or remove a Tab character at 
the beginning of each physical line in a pending-delete selection. 

‘Shift Lines=>Right’, the default, inserts a Tab character at the beginning of the 
line. 

‘Shift Lines=>Left’ removes a Tab character from the beginning of the line. 


The ‘Insert Brackets=>’ puU-right menu lets you insert brackets around a 
pending-delete selection. The bracket choices are (),[],{ },and ” ”, 

The ‘Remove Brackets=>’ pull-right menu lets you remove brackets from a 
pending-delete selection. The bracket choices are the same as for ‘Insert Brack- 
ets=»’. 

The brackets to be removed must begin and end the selection; otherwise no 
action is taken. 


You can customize the ‘Extras=>’ puU-right menu to include your own favorite 
commands by making a new ‘Extras=>’ menu file and placing its name in the 
Extras_menu_f ilename text item in the Text category of the Defaults Edi¬ 
tor. It’s customary to place the file in your home directory as 
~ / . text_extras_inenu. 

The standard ‘Extras=»’ menu file is /usr/lib/ . text___extras___menu, 
shown in Figure 8-9. It will give you some ideas on how to implement your own 
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extras. Once you’ve created a custom file and told the Defaults Editor about it, 
you can make changes to the file and see them immediately implemented in the 
‘Extras=>’ pull-right menu. 


Figure 8-9 *Extras=^’ Menu File in /usr/lib/ . text_extras_menu 


textedit - /usr/1 ib/.text_extras_menu, dir: /home/nutmeg/sagas 


^[Scratch uiindouj 



@(#)text_extras_menu 1.5 87/11/24 SMI 
Copyright (c) 1987 by Sun Microsystems^ Inc. 
Text "Extras" menu 
fmt 


"Capitalize" MENU 

"abed -> ABCD" capitalize -u 

"ABCD -> abed" capitalize -1 

"abed -> Abed" capitalize -c 

"Capitalize" END 

"Shift Lines" MENU 

"Right" shift_lines -t 1 
"Left" shift_lines -t -1 
"Shift Lines" END 


"Pretty-print C" 


indent -st 


"Insert Brackets" MENU 

" ( )" insert_brackets ( ) 

" [ ]" insert_brackets \[ \] 
" { }" insert_brackets { } 

II//II Tnsert_brackets \" \" 
"Insert Brackets" END 

"Remove Brackets" MENU 

" C )" remove_brackets ( ) 

" [ ]" refflove_brackets \[ \] 
" { }" remove_brackets { } 
"vv //II pemove_brackets \" \" 
"Remove Brackets" END 


The name of each ‘Extras=>’ menu item is surrounded by double quotation 
marks ("). Each pull-right menu begins with a MENU statement and ends with an 
END Statement. 

To include a backslash (\) character in the . text_extras__menu file — as in 
the trof f inline font specifications \f B and \f P — you must use four 
backslash characters; for example: 

insert brackets \\\\fB \\\\fP 
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8,12, The ^Cmd Mocles=>^ 
PulTRight Menu 

^Enable Editing’ 


‘Disable Scrolling’ 


The Text menu in command windows contains a special pull-right menu, ‘Cmd 
Modes=>’, in addition to those described above. 

The text in a command window is usually read-only except for the command 
line. To allow all text in a command window to be edited, choose ‘Enable Edit¬ 
ing’. 

When you enable editing, you can use the command window as a scratch pad and 
cross off items you’re done with by deleting them. For instance, use the f grep 
command to find and display all occurrences of a certain text string in a set of 
files. Then delete each display line in the command window as you update the 
files in a Text Editor window. 

The menu item toggles to ‘Disable Editing’ (the normal condition in a command 
window). 


Scrolling is the default in a command window. Most tools that need to disable 
scrolling, such as vi, do it themselves and restore scrolling automatically when 
they’re done. Therefore you normally will never need to disable scrolling. 

However, if you have software that requires you to disable scrolling and you 
want to run it in a command window, choose ‘Disable Scrolling’ before you type 
the command that starts the software. If you disable scrolling by choosing this 
menu item, you must reenable it the same way. 

‘Disable Scrolling’ toggles to ‘Enable Scrolling’, so you can reset the scrolling 
facility when you’re done. 

You may decide instead to run non-scroUing software in a tty window instead of 
a command window — for instance, in Shell Tool rather than Command Tool. 
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8.13. The Tty Menu 


‘Stuff 


‘Enable Page Mode’ 


f 


‘Copy then Paste’ 


Tty windows such as Shell Tool have their own menu, the Tty menu. Its menu 
items are ‘Stuff’, ‘Enable Page Mode’, and ‘Copy then Paste’. 

When you disable scrolling in a command window, you get a Tty menu instead 
of a Text menu. The command window’s Tty menu is just like the one in a tty 
window except that it has an additional menu item, ‘Enable Scrolling’, to take 
the window back to normal command window operations. 


‘Stuff is provided for compatibility with previous releases. Instead use ‘Copy 
then Paste’ or its accelerator ( ♦-? 1 to insert the selection at the block cursor. Or 
use secondary Paste, a quick-editing technique described in Chapter 6, All About 
Selections. 


‘Enable Page Mode’ shows you only a page (windowful) of text at a time, like 
the more command. 

When you choose ‘Enable Page Mode’, the pointer changes to a stop sign when 
the window fills up. Instead of continuing to flow the lines through the window, 
the display stops so that you can look at it as long as you like. 

‘Enable Page Mode’ toggles to ‘Disable Page Mode’, so you can switch back and 
forth at your convenience. 

When you’ve finished looking at the current page (or windowful), press any key 
to see the next page. In addition, ‘Enable Page Mode’ toggles to ‘Continue’ 
whenever there’s more information to be displayed. You can choose ‘Continue’ 
from the menu to display the next page of information. 


‘Copy then Paste’ inserts the selection at the block cursor. It worics just like the 
menu item of the same name in the Text menu’s ‘Edit=>’ pull-right menu. 
You’ll find a description of ‘Edit=>Copy then Paste’ in Section 8.7. 
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All About Accelerators 


This chapter describes: 

o Function key accelerators — menu actions you perform by pressing a func¬ 
tion key on the left side of the keyboard. 

□ Mouse button accelerators — Frame menu actions you perform by clicking 
or holding down a mouse button. 

□ Keyboard accelerators — keyboard combinations you press to erase text, 
move the caret, and perform Text menu actions without using the mouse. 

□ Alert button accelerators — ways to push the button in an alert window 
from the keyboard, without using the mouse. 

Accelerators are alternative ways of doing things in SunView. Their name stems 
from the fact that they’re often easier and faster. For example, 

□ Pressing the I Undo 1 ftmction key 
is the accelerator equivalent of 

o Bringing up the Text menu, 
o Pulling right on the ‘Edit=>’ menu. 

□ Pulling right on the ‘Undo=>’ menu. 

□ Highlighting ‘Undo Last Edit’ and releasing the mouse button. 

See the ‘Again’ menu item in Section 8.7 for an example of how to repeat a com¬ 
plex series of actions using function key accelerators, erase accelerators, and 
caret accelerators. 


9.1. Function Key The function key accelerators, which are described in detail in Chapter 2 in the 

Accelerators Lessons section, let you perform menu operations very quickly just by pressing a 

function key. The menu operations themselves are described in Chapter 8, A// 
About Menus. 

Function keys aren’t the only way to perform menu operations in SunView. See 
Table 9-5, Menu Accelerators, for additional possibilities. 
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The Control Key 


The Shift Key 


The rUoritroIl key is used in conjunction with function keys or keyboard 
accelerator, f Control-Find 1 . an accelerator for ‘Find and Replace’, means hold 

down the f Control 1 key while pressing the f Find! function key. 


The (Shift ] key is used in conjunction with function keys or keyboard accelera¬ 
tors to toggle (switch or reverse) their operation, f Shift-Conirol-Retum I . an 
accelerator for ‘Display=^Move Caret to Start’, means hold down the (Shift! key 
and the fControl I key while pressing the ( Return 1 key. 

The (Shift 1 key is often used to reverse the meaning of an accelerator. For exam¬ 
ple, I Shift-Find I reverses the direction of the [ Find I function key from ‘Forward’ 
to ‘Backward’, and [ Shift-Front) reverses the action of the f Front 1 function key 
from ‘Front’ to ‘Back’. 

The [ Shift I key toggles many other keyboard accelerators as well. For instance, 

(Shift-Control-B 1 reverses the direction of the t Control-B ) caret action 
(Go_Char_Backward) to forward. 


Table 9-1 Function Key Accelerators 


Type4 Keyboard 

Menu Action 

Menu Other Keyboards 

rstopj 

Stop 

— 

rm 

1 ProDS 1 

‘Props’ 

Frame 

rm 

\ Front 1 

‘Front’, ‘Back’ 

Frame 

LL5J 

1 Open J 

‘Open’, ‘Close’ 

Frame 

(ED 

(Find) 

‘Find=i>Find Selection=>Forward’, 
‘Find==>Find Qipboard=>Forward’ 

Text 

fL9l 

(Again J 

‘Edit=> Again’ 

Text 

wn 

1 Undo J 

‘Edit=>Undo=>Undo Last Edit’ 

Text 

(m 

(Copy 1 

‘Edit=>Copy’ 

Text 

(X6] 

1 Paste 1 

‘Edit=>Paste’ 

Text 

riFi 

f Cut] 

‘Edit=>Cut’ 

Text 

iLiOl 

1 Shift-Front 1 

‘Back’ 

Frame 

i Shift-L5 ] 

f Shift-Find I 

‘Find=^Find Selection=>Backward’, 

‘ Find=>Find Clipboard =>B ackward ’ 

Text 

1 Shift-L9 1 

1 Control-Find 1 

‘Find=>Find and Replace’ 

Text 

[ Control-L9 1 


□ [ Open I toggles to ‘Qose’ if the pointer is over a frame rather than an icon. 

□ (Front) brings a partly exposed frame to the front. It toggles to ‘Back’ if the 
frame is completely exposed. 

□ (Shift-Front 1 sends a completely or partly exposed frame to the back. It does 
not toggle to ‘Front’. 

□ If there is a selection, i Find ] is an accelerator for ‘Find=i^Find 
Selection=>Forward’. Without a selection, it’s an accelerator for 
‘Find=>Find Clipboard=>Forward’. f Shift-Find 1 works the same way, but in 
the Backward direction. 
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° ( ♦-FI and (Shift-♦-FI . shown in Table 9-5, Menu Accelerators, are keyboard 

accelerators that operate just like the function key accelerators ( Find 1 and 
[ Shift-Find 1 . 

□ (Control-Find 1 brings up the Find and Replace frame. 


9.2. Mouse Button Mouse button accelerators let you perform Frame menu actions using the mouse. 

Accelerators These accelerators are described in Table 9-2. 

Table 9-2 Mouse Button Accelerators 


Frame Menu Equivalent 

Mouse Action 

Open a frame: 

Point to the icon and click LEFT. 

Move a frame unconstrained: 

Point to a side of the frame 
border near the comer, hold 
down MIDDLE and drag the 
frame, release when the bound¬ 
ing box is the desired size. 

Move a frame constrained: 

Point to a side of the frame 
border near the middle, hold 
down MIDDLE and drag the 
frame, release at the desired 
position. 

Move an icon (always unconstrained): 

Point anywhere in the icon, 
hold down MIDDLE and drag the 
icon to the new location. 

Resize a frame unconstrained: 

Point to a side of the frame 
border near the comer, hold 
down 1 Control )-MIDDLE and 
resize the frame, release at the 
desired position. 

Resize a frame constrained: 

Point to a side of the frame 
border near the middle, press 
! Control 1-MIDDLE and resize the 
frame, release at the desired 
position. 

Zoom a frame to full height: 

Click 1 Control 1-LEFT on the 
frame border. 

Ur^om a zoomed frame: 

Click (Control 1-LEFT on the 
frame border of a frame that has 

been zoomed. 

Bring frame to front: 

Chck LEFT on the frame border. 
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9.3, Keyboard Accelerators 


The Meta (❖) Keys 


9.4, Erase Accelerators 


Table 9-3 


9.5. Caret Accelerators 


There are also accelerators in SunView that are actions, or commands, that you 
type fiom the keyboard. In Tables 9-3 through 9-6 you’ll find the following 
action types: 

□ Erase actions remove text without putting it on the Clipboard. 

□ Caret actions give you keyboard control of the caret. 

□ Menu actions provide menu equivalents. (Not aH menu items have accelera¬ 
tors.) 

o Other actions. 

A command may have more than one keyboard equivalent. The best way to see 
how these commands work is to try them. 


The Meta keys are the diamond (♦) keys on either side of the space bar.^ Meta¬ 
key commands are usually menu item equivalents. You can use whichever Meta 
key is more convenient. Meta keys are used in conjunction with one or more 
other keys to provide keyboard accelerators; for example, ( »-C1 . an accelerator 
for ‘Edit=>Copy’, means hold down the [T] key while typing the letter C. 


Erase accelerators remove text from a document. The text is erased but is not 
placed on the Clipboard. 


Erase Accelerators 


Erase Action 

Keyboard Equivalent 

Erase_Char_B ackward 

[ Delete 1 

Erase__Char_Forward 

(Shift-Delete 1 

Erase_Word„B ackward 

t Control-W! 

Erase_Word_.Forward 

f Shift-Control-W 1 

Erase__Line_B ackward 

f Control-U I 

Erase_Line_End 

1 Shift-Control-U 1 


Caret accelerators let you change the position of the caret in text without having 
to move the mouse. You can keep your hands on the keytward while skipping 
over text to reposition the caret. 


9 On some Sun keyboards, the Meta keys are labeled Left and Right. 
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Table 9-4 Caret Accelerators 


Caret Action 

Keyboard Equivalent 

Go_Char„B ackward 

f RIO 1 (left arrow) 

1 Control-fi ! 

1 Shift-ContTQl-F ) 

Go_Char_Forward 

[ R12 1 (right arrow) 
f Control-F 1 

1 Shift-Control-B 1 

Go_Word_Backward 

1 ConMoX-comma 1 (.) 

( Shift-Control-.s'/a5'/i 1 (/) 

1 Shift-Control-oenod J (.) 

Go_Word_End 

f Control-period) (.) 

Go_Word_Forward 

f Control-slash 1 (f) 

( Shift-Control-comma 1 (,) 

Go_Line_B ackward 

( Control-A 1 

I Shift-Control-E 1 

Go_Line_End 

( Control-E 1 

1 Shift-Control-A 1 

Go_.Line_Forward 

IRllJ 

1 Control-semicolon ) f:) 

Go_Column_B ackward 

IR81 (up arrow) 

1 Control-P 1 

{Shift-Control-N 1 

Go_Column_Forward 

1R141 (down arrow) 

IControl-N) 

( Shift-Control-P 1 

Go_Document_Start 

[R71( [Home)) 

1 Shift-Control-Retum ) 

Go_Document_End 

LRllK lEndl) 
f Control-Return 1 


NOTE Caret actions do not affect the selection if there is one. 

The indented caret action commands use the I Shift ] key as a toggle. For exam¬ 
ple, (Shift-Control-F I (Go_Char_Backward) reverses the action of I Control-F I 
(Go_Char„Forward). By using the f Shift) key, you can reduce the number of 
commands you need to remember. 

The following caret commands are described relative to the current position of 
the caret. If the caret is in the middle of a word, it moves to the beginning or end 
of that word. 

o Go_Word_Backward moves the caret to the left until it’s at the beginning of 
a word. 

□ Go_Word_End moves the caret to the right until it’s at the end of a word. 

□ Go_Word_Forward moves the caret to the right until it’s at the beginning of 
a word. 
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The Home and End Keys 


Arrow Keys 


Caret Action Mnemonics 


o Go_Line_End moves the caret to the end of the current line. If the caret is 
already at the end of the current line, it moves to the end of the next line 
down. 

□ Go_Line_Forward moves the caret to the beginning of the next line down. 

□ Go_Column_Backward and Go_Column„Forward move the caret up or 
down in the same column as long as the next line is at least as wide as the 
current line. If the next line is narrower, the caret moves to the end of the 
line; it returns to the original column when the next line is wide enough. 

Go_Document_Start is the (Home) key (R7) on the Type4 keytx)ard, and 

Go_Document_End is the (End) key (R13). 

□ ( Home 1 is a keyboard accelerator for the menu item ‘Display=>Move Caret 
to Start’. 

□ (End] is a keyboard accelerator for the menu item ‘Display=>Move Caret to 
End’. 

[ Shift-Control-Retuml is another accelerator for ‘Display=>Move Caret to Start’, 

and [ Control-Return 1 is another accelerator for ‘Display=>Move Caret to End’. 


The arrow keys perform the following caret actions: 


Caret Action 

Arrow Key Equivalent 

Go_Char_Forward 

(R121 (right arrow) 

Go_Char_Backward 

[ RlO 1 (left arrow) 

Go_Column_Forward 

(R14 ) fdown arrowl 

Go_Column_B ackward 

[ R81 tup arrow) 



Caret accelerators that use I Control I key combinations have names that are easy 
to learn. 

F, B, N, and P stand for forward, backward, next line, and previous line. For 
emacs users, these keys are the equivalent of arrow keys.^® When pressed 
together with the i Control 1 key, they do the same thing in SimView. 

A and E are the emacs commands for beginning-of-line (think of alpha) and 
end-of-line. When pressed together with the 1 Control ] key, they do the same 
thing in SunView. 


emacs is an editor that can be used in tty and command windows. 
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9.6. Menu Accelerators 


Table 9-5 contains menu accelerators for the Text menu. Additional menu 
accelerators for the Text and Frame menus are shown in Table 9.1, Function Key 
Accelerators. 


Table 9-5 Menu Accelerators 


Menu Action 

Keyboard Equivalent 

‘File=^>Store as New File’ 

1 4-51 

‘File=>Load File’ 

1 4-L] 

(fisc! 

‘File=»Include File’ 

1 4-11 

1 Shifl-Esc 1 

‘File^i^Set Directory’ 

[Esc] 

‘File=>Empty Document’ 

[♦-EJ 

‘Edit=> Again’ 

L±:AJ 

‘Edit=:>Undo’ 

U-UI 

‘Edit=>Copy’ 

[ 4-C] 

‘Edit=>Paste’ 

U-vj 

‘Edit=>Cut’ 

f t-Xl 

‘Edit=>Copy then Paste’ 

1 ♦-?) 

‘Display=>Move Caret to Start’ 

1 Home ) ( (R7 ] ) 

1 Shift-Control-Retum) 

‘Display=>Move Caret to End’ 

lEndlC fR13]) 

1 Control-Return 1 

‘Find=?>Find and Replace’ 

1 Control-Find) 

‘Find=>Match Delimiter’ 

1*-DJ 

‘Find=J>Replace l>field<l=^Next’ 

1 Control-Tab 1 

‘Find=»Replace l>field<l=>Previous’ 

f Shift-Control-Tab 1 

‘Find=>Find Selection=>Forward’ or 
‘Find=>Find Qipboard=>Forward’ 

[ ♦-F) 

‘Find=>Find Selection=>Backward’ or 
‘Find=>Find Qipboard=>Backward’ 

[Shift~#-F] 


Except as noted below, a menu accelerator operates just like the menu item with 

the same name. 

° f Esc 1 is an accelerator for ‘Load File’ and ‘Set Directory’. Type the path¬ 
name by itself on the first line in the document. Then press fEscl . If the 
pathname is the name of a file, the line will be selected automatically and 
replaced by the contents of the file. If the pathname is the name of a direc¬ 
tory, the directory will be changed and the new name will appear in the 
frame header. 

o f Shift-Escl is an accelerator for ‘Include File’. Type the filename by itself on 
the line in the document where you want the file inserted. (The caret must 
be on the same line.) Then press I Shift-Esc 1 . The filename will be selected 

automatically and replaced by the contents of the file. 
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a (Esc l and fShift-Esc 1 and related Meta keys f'i-Ll and f apply only to 

text windows. 

□ When there’s a selection, f ♦-FI is an accelerator for ‘Find=>Find 
Selection=>Forward’. Without a selection, it’s an accelerator for 
‘Find=>Fmd Clipboard=»Forward’. ( Shift-♦-F) works the same way in the 
backward direction. 


9.7. Other Keyboard Here are some additional keylx)ard accelerators. 

Accelerators 


Table 9-6 Other Keyboard Accelerators 


Other Action 

Keyboard Equivalent 

Caps_Lock 

[FTI 

Quote 



□ The I FI I key works like a function key. It operates on the text you type. 
Normal typing produces capital letters only when you press the (Shift I key. 
The (FI I key lets you produce aU capital letters or toggle back to normal 
typing, as the (Ca ps Lock) key does. However, fFll is a SunView software 
feature that operates on one window at a time, while 1 Caps Lnckl is a key¬ 
board hardware feature that affects all windows. Press the I FI1 key with the 
keytx)ard focus in the window whose typing you want to affect. When the 
window toggles to all capital letters, the word [ CAPS ] appears in the frame 
header. Pressing 1 FI 1 again toggles the window back to normal typing. 

° 1 ♦-01 (Quote) lets you “quote” a keyboard accelerator in text instead of exe¬ 

cuting it. (The character that represents the keyboard accelerator may not 
be a printable character.) For example, type ft-01 f ♦-$ ] to enter the char¬ 
acter string that represents ( f-Sl (Meta-S) as text. 


9.8. SunOS 3.x Keyboard For reference, Table 9-7 shows the keyboard commands available for SunView 
Accelerators in SunOS 3.0, 3.2, and 3.4: 


Table 9-7 SunOS 3 jc Keyboard Accelerators 


Erase Action 

3.x Keyboard Equivalent 

Erase_Char_B ackward 

□Delete 1 

Erase_Char_Forward 

{Shift-Delete 1 

Erase_Word_Backward 

(Control-W 1 

Erase_Word_Forward 

(Shift-Control-W 1 

Erase_Line_B ackward 

(Control-U 1 

Erase__Line_End 

f Shift-Control-U 1 
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Caret Action 

3.x Keyboard Equivalent 

Go_Docume.nt_End 

f Control-Return 1 


Menu Action 

3.x Keyboard Equivalent 

Get_Filename_and_Load 

1 Esc 1 

Find_Backward 

1 Shift-Control-F 1 

Find„Forward 

[ Control-F! 

‘Paste’ 

1 Control-G 1 

‘Cut’ 

(Control-D 1 

‘Copy then Paste’ 

[ Control-P 1 

Caps_Lock 

CED 


Additional 3.x accelerators are listed in Table 9-1. 


9.9, Alert Button 
Accelerators 


You can respond to alert buttons from the keyboard. 


Figure 9-1 Alert Buttons 




The text has been edited. 

Empty Document will discard these edits. Please confirm. 


fConfTnn, discard ~e^T^ 


[Ca ^el] 


□ To reply to the alert message by responding Confirm or another obvious 
yes, press the I Return I key. The button that responds to I Return ) — the yes 
choice — has a double outline, as shown in Figure 9-1. 

□ To reply to the alert message by responding Cancel or another obvious no, 
press the ( Stop 1 function key. 
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The Defaults Editor 


The Defaults Editor is the key to using SunView comfortably and efficiently. A 
default is a standard way of doing something. For example, pull-right menus are 
the standard in SunView. The Defaults Editor lets you change the SunView 
defaults to suit your preferences. 

It’s a good idea to experiment with the default settings and find out which ones 
you like best. Later in this chapter you’ll find a list of defaults that are likely to 
be of interest to you. 


The preferred way to start the Defaults Editor is to bring up the SunView menu 
and choose ‘Defaults Editor’ from the ‘Editors=»’ pull-right menu. 

You can also start the Defaults Editor in the background from a Command Tool 
or Shell Tool by typing: 






venus% defaultsedit & 




_7 


10.2. Quitting the Defaults When you’re done changing defaults, choose ‘Quit’ or ‘Qose’ from the Defaults 
Editor Editor’s Frame menu. If you choose ‘Close’, you’ll see an icon that looks like 

this: 


10.1. Starting the Defaults 

Editor 


Figure 10-1 The Defaults Editor Icon 
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10,3, The Defaults Editor The Defaults Editor frame contains three panels and a scratch window, as shown 
Windows in Figure 10~2. 

Figure 10-2 The Defaults Editor Frame 
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■ 
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1 

Conf i ™_Property_Qianges 
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From top to bottom you see the Control panel, the Message panel, the Defaults 
panel, and the scratch window. 

The Control Panel The Control panel lets you manage viewing and changing defaults. 


The Category Cycle Item When you start the Defaults Editor, the SunView category defaults are displayed. 

There are nine other categories of defaults. They’re listed in the Category menu, 
which you bring up by moving the pointer over the Category cycle item and 
holding down the RIGHT mouse button. You can choose any category from the 
menu to display its defaults in the Defaults panel. You can also click LEFT on 
the Category cycle item to cycle through the categories. 

Each category has standard defaults that are taken from files in the 
/usr/lib/defaults directory. The filenames consist of the category name 
plus a . d suffix. Individual defaults in each category are then overlaid by the 
changes you’ve made, which are stored in the .defaults file in your home 
directory. The first time you start SunView, you haven’t changed any defaults 
yet so you don’t have a . default s file. The file is created the first time you 
push the Save button in the Default Editor’s Control panel. 
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The Save Button 


The Quit Button 


The Reset Button 


The Edit Item Button 


The Message Panel 


The Defaults Panel 


The Scratch Window 


10,4. Cycling Through 
Categories 


If you want to return to all the standard SunView defaults, just rename or delete 

the "/ .defaults file. 


You can make as many changes to a category as you like, and then change your 
mind. Changes don’t become permanent until you push the Save button. 


Pushing the Quit button is the equivalent of choosing ‘Quit’ from the Defaults 

Editor’s Frame menu. 


If you’ve made changes to a category and you want the defaults to return to the 
way they were the last time you pushed the Save button, push the Reset button. 


The Edit Item button is for experts who need to modify default lines in the 
Defaults panel. That’s probably all you need to know about it. If you’re one of 
the rare few, you’ll find a description in Section 10.7, Editing Default Lines. 


The Message panel is where the Defaults Editor displays text such as the help 
messages that tell you how a particular default works. 


The main element in the Defaults panel is the default line. From left to right, the 
default line contains the default name, the standard SunView setting (in 
parentheses), and a default value — a text item or cycle item where you specify 
the changed default. 

When you click LEFT on the default name or the default value, a help message 
appears in the Message panel. The help message for the default name explains 
the purpose of the default. For cycle items, the help message for the default 
value explains the effect of a particular setting. 

The Defaults panel varies from category to category. For instance, in the Com¬ 
patibility category it also contains explanatory text, and in the Scrollbar 
category it also contains a panel button. 


The scratch window in the Defaults Editor frame is similar to the one in the Text 
Editor frame. It’s a text window used for temporary editing. 

The scratch window is provided so that you can easily edit long text items that 
are not fuUy visible in the Defaults panel. Just copy the text item into the scratch 

window, edit it there, and paste it back where it came from. 


The defaults that the Defaults Editor works with are divided into categories — 
related defaults are grouped together. 

It’s a good idea to familiarize yourself with the various categories by going down 
the list of default names in each category and viewing the help messages associ¬ 
ated with them. 
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Compatibility Category 


Defaults Category 


Indent Category 


Input Category 


Mail Category 


Menu Category 


Scrollbar Category 


To cycle to a category, click the LEFT mouse button on the cycle symbol until the 
category you want is displayed. Qick or hold down f $hift1 -LEFT to cycle back¬ 
ward. 

You can also cycle directly by holding down the RIGHT mouse button on the 
cycle symbol to open the Category menu, then choosing the category you want 
displayed. 

The categories are described below in alphabetical order: 


The Compatibility category lets you change SunView defaults to correspond to 
previous releases of SunView. For example, you can request the SunView 3.0 
Text menu instead of the Text menu described in this manual. 


The Defaults category contains defaults that affect the use of the Defaults Editor 
itself. It’s used mainly by software developers. 


The Indent category sets defaults for the indent command, described in the 
SunOS Reference Manual This category affects the action of the ‘Pretty-print C’ 
menu item in the ‘Extras=>’ pull-right menu. 


The Input category is concerned with defaults for the mouse and the keyboard. 

The noraial way to change input defaults is through the Defaults Editor. How¬ 
ever, if you have changed input defaults in the SunOS operating system by using 
the stty command, you can teU the Defaults Editor to read in those changes by 
pushing the panel button. Click to start setup program: defaults from input. 


The Mail category sets defaults for Mail and Mail Tool. The defaults are 
described in the Mail and Messages: Beginner’s Guide manual. 


The Menu category lets you change the appearance of menus, determine how 
menu defaults are set, and specify what happens to the pointer after you choose 
from a menu. 


The Scrollbar category lets you change the appearance of the scroUbar. For 
example, the default is to display the scroUbar aU the time, but you can have the 
scroUbar displayed only when you’re scroUing. 

The scroll defaults program demonstrates the effect of the defaults in this 
category. To start the program, push its button in the Defaults panel. 
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Sub View Category 

Text Category 

Tty Category 

105. Changing Defaults 

Saving Changes 

When Changes Take Effect 


The SunVIew category lets you change defaults that are universal throughout 
SunView such as the font that is used in frame headers and elsewhere. For exam¬ 
ple, this is where you change the defaults for icon gravity and keyboard focus. 


The Text category lets you change characteristics of text windows and command 
windows. 


The Tty category lets you change certain characteristics of tty windows and com¬ 
mand windows. 


You can change defaults in one category or several categories. 

Default values are set either by text items or cycle items. 

□ To change a default value that’s a text item, type or edit as you would any 
panel text item. If the text is too long to be edited in the Defaults panel, 
copy it into the scratch window, edit it there, and then paste it back into the 
text item. This technique may be required for long pathnames. 

□ To change a default value that’s a cycle item, click LEFT on the cycle item or 
choose from its menu. Each new setting causes a new help message to 
appear in the Message window. 


To save the current category, push the Save button. You should save the changes 
before cycling to the next category you want to change. If you forget, an alert 
message will remind you. 

If you don’t want to save changes — if you’ve changed your mind or made an 
error—push the Reset button. 


Changes to defaults take effect at different times, depending on the category 
you’re changing. Table 10-1 shows when changes take effect for all the 
categories. 
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Table 10-1 When Changed Defaults Take Effect 


Category 

When Changed 

Compatibility 

When a tool is started. 

Defaults 

Next time SunView is started. 

Indent 

Next time you run indent. 

Input 

Immediately. 

Mai! 

When you start Mail Tool or choose ‘Source .mailrc’. 

Menu 

SunView menu: Next time SunView is started. 


Other menus: When a tool is started. 

Scrollbar 

When a tool is started. 

SunView 

Next time SunView is started. 

Text 

When a tool is started. 

Tty 

When a tool is started. 


10.6. Some Interesting Here are some defaults you should consider including in your experiments with 

Defaults the Defaults Editor. They’re popular with many SunView users. The name of 

the category precedes the default name in the following list: 


Input/Left_Handed 

If you’ve decided to put your function keys on the right side of the 
keyboard and use your mouse on the left side, you need to tell Sun¬ 
View by setting Input/Lef t_Handed to Yes. The default is 
No. 


Menu/Center_string_items 

By default, names of menu items are left-justified. Some users find 
that centered menu items are easier to read. To center menu item 
names, set Center_string_items to True, 


Menu/Default_Selection and Initial_Selection 

The default setting for these menu items is Default. Change the 
setting to Last_Selection if you want the default for pull-right 
menus to be the menu item you chose last time you brought up the 
menu. Each pull-right menu has a separate default it “remembers.” 
Caution: You have to remember too, because blind choices can get 
you into trouble. For instance, your last choice in the ‘Edit=>’ pull- 
right menu may have been ‘Undo All Edits’. 


Menu/Font, Text/Font, and SunView/Font 

If you don’t like the fonts you see on the screen, you can change 
them by specifying any of the fonts in the 

/usr/lib/f onts/f ixedwidthf onts directory, or by design¬ 
ing your own fonts with the Font Editor. 
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Menu/Stay_up 

If you’d rather not keep holding down the mouse button while you 
decide on a menu item, you’ll like stay-up menus. When you click 
RIGHT, the stay-up menu appears, and it stays there until you click 
RIGHT again. You can preview it at your leisure. To change to 
stay-up menus, set Stay__upto True. 


Scrollbar/Vertical_bar_placement 

By default, the scrollbar is on the left side of the window. If you 
notice that the pointer often strays into the scrollbar when you’re try¬ 
ing to select the beginning of a line, see if setting 
Vertical_bar_placenient to East works better for you. 
That puts the scrollbar on the right side of the window. Another 
solution is to increase the width of the left margin — the space 
between the frame border and the leftmost text in the window — by 
changing the value of Text /Left_margin from the default 
width of four pixels. 


SunView/Click_to_Type 

The default keyboard focus is Pointer-in-Window. To change to 
Click-to-Type, described in Chapter 4, set Click_to_Type to 
Enabled. 


SunView/Enibolden_Labels 

You can make the text in frame headers stand out more by changing 
SunView/Embolden_Labels to Enabled. The default is 
Disabled. 


SunView/Icon_gravity 

The default icon gravity. North, puts icons at the top of the screen 
when frames are closed. To keep icons on the left side of the screen, 
cycle Icon_gravity to West, and so on. 


Text/Adjust_is_pending_delete 

If you want the primary selection to become pending-delete when¬ 
ever you adjust it, set Adjust_is_j)ending_delete to 
True. Adjust_is_pending_delete has the same effect as 
holding down the ( Control I key when adjusting a selection. This set¬ 
ting is useful for editing, since ordinarily you adjust a primary selec¬ 
tion prior to replacing or deleting it. You can make a pending-delete 
selection into a normal selection by adjusting it while holding down 
the I Control I key. The default setting for 
Adjust_is__pending__delete is False. 


T e X t / Au t o__i n de nt 

If you want each new line of text you type to have the same white 
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I J 

space as the previous line, set Auto__indent to True. Lines 
you insert using the f Copy I or [ Paste 1 function keys are not affected. 

This setting is often preferred by programmers. The default setting 
for Auto indent is False. 


Text/Checkpoint_frequency 

You can ask to have your Text Editor document checkpointed every 
n edits. The checkpoint filename ends with the suffix %%. If you’re 
editing the lessonl. limerick file and the 
Checkpoint_f requency default value is 20, a checkpoint file 
named lessonl. limerick%% is written every twenty edits. The 
default is 0 (no checkpointing). 


Text/Edit_back_char 

Edit_back_char is the delete character. The default is the value 
produced by pressing the (Delete ] key. To make the f Back Space 1 
key the default, change the Edit_back_char default value to 
\^H. 

Text/Insert_makes_caret_visible 

You might prefer to have text windows set up so that when you 
insert text, the caret becomes visible even if it wasn’t visible before. 
To do that, cycle Text/Insert_makes_caret_visible to 
Always. The default is If_auto_scroll. 


Text/Scratch_window 

You can specify the number of text lines in the Text Editor’s scratch 
window. Extra lines are useful if you do a lot of work in the scratch 
window. For example, when Scratch__window is setto 5, a 
five-line scratch window is created whenever you start a Text Editor. 
The default value is a one-line scratch window. 


Tty/Text___wraparound_size 

The Console writes its history into the /tmp directory. The default 
buffer size is 0, which gives you an infinite buffer. You can avoid 
filling up /tmp by changing Tty/Text___wraparound_size to 
a reasonable number of characters — say, 50,(XX) — after which the 
space will be reused starting over at the beginning. 


10.7. Editing Default Lines Normally, the default line is read-only except for the text item or cycle item 

where you set the default value. However, the Defaults Editor gives you the 
capability of editing default lines in the various categories. 

NOTE You shouldn’t attempt using the Edit Item button unless you’re a “power user.” 
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The Edit Item button has a menu containing the following menu items: 

o ‘Copy Item’ duplicates the selected default line. (You select a default line 
by clicking LEFT anywhere in the line.) You can then edit the default name 
and the default value of the new item. Only items with text or numeric 
values can be copied. ‘Copy Item’ is useful when you want to change 
several instances of an item type — for example, to insert a new mail alias 
into the defaults database. 

□ ‘Delete Item’ removes the selected default line from your private defaults 
database. You can’t permanently delete a default that’s defined in the sys¬ 
tem database, but you can make it behave like an undefined item by giving it 
the special value \255Undefined\255. The first and last bytes of this 
string have the ASCII code 255. 

□ ‘Edit Label’ lets you edit the default name of the selected default line. 

When you choose ‘Edit Label’, the default name in the selected line changes 
from bold to normal font. You can then select the default name and edit it as 
you would any panel text item. 
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All About Tools 


This chapter contains brief descriptions of the tools in the standard SunView 
menu. A tool is a shell, editor, or other application that runs in SunView. The 
tools are discussed in the same order as they appear in the SunView menu. For 
more information about a tool covered in this chapter, look up its command 
name in the Tool Names Cross-Reference, Table 11-1, then find the command in 
the SunOS Reference Manual. 


11.1. Starting a Tool 





To start a tool, choose its menu item from the SunView menu, as shown in Fig¬ 
ure 11-1. 


Figure 11-1 Starting a Tool 


Shells =» 

Tools 

Services 
Exit SunVi 


Text Editor 

Defaults Editor 



Font Editor 




You can also start a tool from a SunOS command line, including a command line 
in Command Tool, Shell Tool, or any other SunView command window. 

□ To start a tool from a command line, type: 

---^^ 

venus% command [S] 


command is the name by which the tool is known to the SunOS operating sys¬ 
tem. The command names for all of the tools in the SunView menu are cross- 
referenced in Table 11-1. 

& is an optional parameter that causes the tool to ran “in the background” — not 
the SunView background display, but the SunOS job control background 
described in the Getting Started with SunOS: Beginner’s Guide and Doing More 
with SunOS: Beginner’s Guide manuals. 
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The following example shows you how to start tools from a command line so 
that the Defaults Editor runs in the background and the Text Editor runs in the 

foreground: 



venus% 

defaultsedit & 

. ■ 


Venus% 

[1] 6062 



venus% 

textedit 







The first line in the example starts the Defaults Editor in the job control back¬ 
ground. The second line contains SunOS Job control feedback (described in 
Doing More with SunOS: Beginner’s Guide). The third line starts the Text Edi¬ 
tor in the foreground. 


11.2, Tools Cross- 
Eeference 


Table 11-1 lists the tools in the SunView menu and indicates the SunOS com¬ 
mand name associated with each one. You can look the command names up in 
the SunOS Reference Manual for further information. 


Table 11-1 Tool Names Cross-Reference 


SunView Menu 

Command in SunOS 

Command Tool 

cmdtool 

Shell Tool 

shelltool 

Graphics Tool 

gf xtool 

Text Editor 

textedit 

Defaults Editor 

defaultsedit 

Icon Editor 

iconedit 

Font Editor 

fontedit 

Mail Tool 

mailtool 

Dbx (debug) Tool 

dbxtool 

Performance Meter 

perimeter 

Clock 

clock 

Lock Screen 

lockscreen 


11.3. Shells The ‘Shells=>’ pull-right menu contains the names of SunView shells. A shell is 

a window that accepts SunOS commands, such as Command Tool and Shell 
Tool. Most SunView users work with several shells open at the same time. 
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Command Tool 


/bin/csh 


Command Tool is a command interpreter that displays a standard SunView text- 
based command window with scrolMng. For more information on command win¬ 
dows and the ‘Cmd Modes=>’ pull-right menu, see Sections 5.3 and 8.12. 

Command Tool is an enhancement designed to replace Shell Tool. You can do 
anything in Command Tool that you can do in Shell Tool. In addition, Com¬ 
mand Tool gives you the advantages of scrolling and the availability of the full 
Text menu rather than the limited Tty menu. 

The Command Tool icon is shown to the left. The Command Tool Frame is 
shown in Figure 11-2. 


Figure 11-2 Command Tool Frame 


iindtaol - /b1n/csh 
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patrick_henry.doc sched.doc 

venus'/i head -3 patrick_hBnry.doc 

I don't know why they always misquote me about liberty. 

What they say I said ain't what I said at all. 

Here are sane of the remarks I've made recently on the subject. 
venus% fgrep -n "Give me liberty" ’*.doc 

patrick_henry.doc;4;Give me liberty or I'll give you what-for. 
patrick_henry.doc:5:Qive me liberty or I'll give you a piece of my mind. 
patrick_henry,doc;7:Give me liberty or give me a salami on rye. 
patrick_henry .doc:8:Give me liberty or give me a raise. 
patrick_henry.doc;9;G1ve me liberty or give me a free lunch. 
patrick_henry.doc:10:Give me liberty or give me a break. 
patrick_henry.doc:11iWhat I want for my birthday is: Give me liberty. 
patrick_henry.doc;12:You know what I always say—Give me liberty! 
patrick_henry.doc:13:Give me liberty or I'll go on strike. 

patrick_henry.doc;14;"Give me liberty" seems to lose its meaning after a while. 
patrick_henry.doc:15;Maybe the boy who cried wolf really cried, "Give me liberty 
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Shell Tool 








W 



/bin/csh 


Shell Tool is a command interpreter that displays a tty window. For more infor¬ 
mation on tty windows and the Tty menu, see Sections 5.5 and 8.13. 

Command Tool has all of Shell Tool’s features plus some that Shell Tool lacks. 
Even if you’ve grown accustomed to SheU Tool, you may want to try Command 
Tool for the same tasks and see if you prefer it. 

The SheU Tool icon is shown to the left. The SheU Tool Frame is shown in Fig¬ 
ure 11-3. 


Figure 11-3 Shell Tool Frame 


shelltool - /bin/csh 


venusVs Is *.doc 

liberty,doc patrick_henry.doc sched.doc 

venus% head -3 patrick_henry.doc 

I don't know why they always misquote me about liberty. 
i*/hat they say I said ain't what I said at all. 

Here are sane of the remarks I've made recently on the subject. 
venus% fgrep -n "Give me liberty" "'.doc 
1iberty .doc:4:Give me liberty or I'll give you what-for. 

1iberty.doc:5:6ive me liberty or I'll give you a piece of my mind. 

I liberty.doc:7:Give me liberty or give me a salami on rye. 

1iberty.doc;8:G1ve me liberty or give me a raise. 

1iberty.doc:9:Give me liberty or give me a free lunch. 

1iberty.doc:10;Give me liberty or give me a break. 

1iberty ,doc:11;What I want for my birthday is; Give me liberty, 
liberty,doc:12;You know what I always say—Give me liberty! 
liberty.doc:13;Give me liberty or I'll go on strike. 

1iberty.doc:14:"Give me liberty" seans to lose its meaning after a while, 

1iberty.doc:15:Maybe the boy who cried wolf really cried, "Give me liberty!" 

patrick_henry.doc:4;Give me liberty or I'll give you what-for. 
patrick_henry.doc:5:Give me liberty or I'll give you a piece of my mind. 

patrick_henry.doc:7;Give me liberty or give me a salami on rye. 

fcatrick_henry.doc:8:Give me liberty or give me a raise. 
patrick__henry.doc:9:6ive me liberty or give me a free lunch. 
patrick_henry.doc:10 :Give me liberty or give me a break. 
patrick_henry.doc:lliWhat I want for my birthday is: Give me liberty. 
patrick_henry.doc:12;You know what I always say—Give me liberty! 
patrick_henry.doc;13;Give me liberty or I'll go on strike. 

patrick_henry.doc:14;"Give me liberty" seems to lose its meaning after a while. 
patrick_henry.doc:15iMaybe the boy who cried wolf really cried, "Give me liberty 

I" 

venus'/o rm liberty.doc 
rm; ranove liberty.doc? y 
venus% [] 
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Graphics Tool displays two windows for running graphics programs. 

The upper window is a tty window (just like Shell Tool) where you can type 
commands that run graphics programs and other SunOS commands. 

The lower window, which is gray when Graphics Tool starts, displays the graph¬ 
ics output of the command running in the tty window. 

The Graphics Tool icon is shown to the left. The Graphics Tool frame is shown 
in Figure 11-4. 


Figure 11-4 Graphics Tool Frame 


gfxlool; /bin/csh 


venus7o Is /usr/demo 
bouncedemo® cursor_demo@ 

canvas_demo@ framedemo® 

venus'A /usr/demo/bouncedemo 

f] 


jimpdemo® 

spheresdano® 
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Console 


The Console frame displays error messages and other messages from SunView 
and SunOS. A Command Tool is the recommended system console, but you can 
start a Shell Tool as your Console frame. 


NOTE Always have one and only one Console frame. 

The system messages that appear in the Console window are written into the 
/tmp directory. If your system generates a great many messages, they may use 
up aU the available space in/tmp. You can avoid this potential problem by 
using the Defaults Editor to set Tty/Text_wraparound_size to a reason¬ 
able numter; say, 50,(XX) characters. Then when the space you’ve allocated has 
been used up, the Console frame will reuse it by wrapping around to the begin¬ 
ning. 



console 


The Console icon is shown to the left. The Console frame is shown in Figure 
11-5. 


Fi gure 11-5 C onsole Frame 


Default settings assumed. 
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11.4. Editors The ‘Editors=>’ pull-right menu contains the names of tools for creating and 

revising documents, icons, and fonts, plus a tool that lets you change SunView 
defaults. 


Text Editor 



The Text Editor lets you create and revise text files. This manual describes the 
Text Editor in detail. The Lessons section provides an introduction for first-time 
users of window-based editors. 

The Text Editor icon is shown to the left. The Text Editor frame is shown in Fig¬ 
ure 11-6. 


Figure 11-6 Text Editor Frame 


textedit - bedtime_story,. dir: /ham©/nutmeg/sagGS 


I Scratch uiindou) ~/bedtiine_story^ 



A Bedtime Story 

Once upon a time there was a beautiful queen in a city by the 
!a. The queen was as good as she was beautiful, and all her 
subjects loved her. The city she ruled had fresh air, good harvests, 
land the blessings of peace. There was just one problen; the 
I computers were always dcwn! 

The baker said to the customers, "How can I tell if there's 
rye bread in the oven? Hy computer is down!" 

The blacksmith said to the stable owner, "How can I tell if 
your horses will be shod next Tuesday at 3:00? My conputer is down!" 

The quality of life in the city by the sea grew worse and 
worse. The queen sat on a balcony of the castle, looking down on her 
unhappy subjects, and she thought, and she thought, and she thought. 
All of a sudden she leaped from her bench. 

"I know," she cried, "I will make a network!" 

So she called in experts from all over the world. They 
brought powerful magic scrolls full of words like "abracadabra" and 
"coaxial cable" and "multiplexor box," and they unrolled the scrolls 
and chanted before the queen. And as they chanted, all the conputers 
in the city by the sea began to talk to one another. 

"I'll trade you a dozen bagels for a pony ride," said the 
baker's computer to the stable owner's computer. 


"I'll meet you in the orchard when the moon rises,' 
carpenter's computer to the schoolteacher's computer. 


said the 


All the people of the city gathered before the castle 
rejoicing. They looked up at the queen, who beamed down upon than 
from her balcony, and they shouted, "The net works! Long live the 
queen!" 

The queen ruled for many years, and the ccmputers never went 
dcwn again, and they all lived happily ever after. 

The End 
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Defaelts Editor 


n n 

FAULTS 


The Defaults Editor is a tool for customizing SunView by changing the standard 
defaults. This editor has a whole chapter devoted to it. You’ll find a description 
of its windows and a discussion of some important defaults in Chapter 10. 

The Defaults Editor icon is shown to the left. The Defaults Editor frame is 
shown in Figure 11-7. 


Figure 11-7 Defaults Editor Frame 


defaultbedit 


Category O SunView fS'ave'l fResetl 


t'aii ] 


Get iCLP by clicking the left button on the appropriate label or strir^ 
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Icon Editor 



The Icon Editor is a tool for creating and revising icon and cursor images. You 
can create a new icon or cursor and store it in a file. You can also load a file that 
contains an icon or cursor image, edit it, and save it. 

The Icon Editor icon is shown to the left. The Icon Editor frame is shown in Fig¬ 
ure 11-8. 


Figure 11-8 Icon Editor Frame 
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To load an image: 

□ In the File: text item in the control panel, type or copy the pathname of the 
file that contains the image you want. (You can find standard SunView 
icons, pointers, and cureors in the /usr/include/images directory.) 

o Push the Load button by clicking LEFT on it. The image appears in the 
drawing canvas, the large window on the left side of the Icon Editor frame. 

To store an image: 

□ In the File: panel text item, type or copy the pathname of the file where you 
want to save the image. If you’re editing an existing file, the pathname is 
already there. 

□ Push the Store button. 
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To create or change an image: 

□ Set the control panel on the right side of the frame to draw joints, lines, rec¬ 
tangles, circles, or text Then click LEFT to draw a point or paste the fill text 
into the drawing canvas, or hold down LEFT and drag to draw a line, rectan¬ 
gle, or circle. 

□ Click MIDDLE or hold down and drag MIDDLE to erase. 

Every change you make in the drawing canvas is reflected in the proof window in 
the lower right comer of the Icon Editor frame. The proof window shows you a 
life-size version of the image as it would appear on the SunView background. 

To save a new image: 

□ Type its filename in the File: text item and push the Store button. If neces¬ 
sary, type a new directory pathname. 

For more information on the Icon Editor, see the iconedit manual page online 
or in the SunOS Reference Manual 
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The Font Editor is a tool for creating and revising font images. 

The Font Editor icon is shown to the left. The Font Editor frame is shown in Fig¬ 
ure 11-9. 


Figure 11-9 Font Editor Frame 


fontedit 


I Pres 

IJstoreJ fQu'it'j Font name: /usr/1 ib/fonts/f ixeciiJldthfonts/ser1f .r. 12 
I Max Width: 7 Max Height: 14 

Caps Height; 10 X Height: 7 Baseline: 10 fApply] 

Operation: QSingle Pt HPt Wipe Qline QRect QCut QCopy 0 Paste 


Press and hold button to wipe points. 

fLoad') {Storej [Quit] 

Max Width: 7 



To load an existing font: 

□ Type its pathname in the Font name: text item in the control panel. You 
will find the standard SunView fonts in the 

/usr/lib/fonts/f ixedwidthfonts directory. 

□ Push the Load button. 

To load an individual character: 
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□ Click LEFT in the slider to indicate the range of characters you want 
displayed. The slider is the long horizontal box that shows you where to 
click to get chai'acters in the range of 0-9, A-z, and a-z. Eight characters 
at a time are displayed in edit buttons above the slider. 

□ Click LEFT in an edit button to display it in enlarged format in an edit pad 

below the slider. 

□ Set the Operation choice item in the control panel to indicate what opera¬ 
tion you want to perform. 

To save an individual character: 

o Push the rectangular Store button next to the enlarged image of the charac¬ 
ter. 

To save an entire font: 

□ Change the Font name: text item if necessary, and push the lozenge-shaped 
Store button in the control panel. 

For further instmctions on creating and editing fonts, see the font edit com¬ 
mand online or in the SunOS Reference Manual. 


11.5. Other Tools 


The ‘Tools==>’ puU-right menu contains the names of some important applica¬ 
tions. 
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Mail Tool 



Mail Tool provides windows for sending and receiving mail messages over the 
network. The Mail and Messages: Beginner’s Guide manual contains a complete 
description of this tool. You’U enjoy reading the sample mail. 

The Mail Tool icon is shown to title left. The Mail Tool frame is shown in Figure 
11 - 10 . 


Figure 11-10 Mail Tool Frame 


mail tool - folder: 4bugs 


57 To marthaewashington 

58 marthaftijashington 

> 59 abigailSadams 


Fri Oct 9 13:36 
Fri Oct 9 14:01 
Thu Oct 15 09:47 


77 messages 20 neu 


35/1127 Church Po 
29/885 Re: Chur 
54/2162 A Most Gr 


[ Shouj ) [ Next ete j[ Reply ][Compose*) 

f Save Fo1der~j File: +bug^ 


[ Print ][Neui Mail] 
"j f Done 1 


Misc 


^To: do!lySmadison 

Subject: A Most Grievous and Unfortunate Circumstance 
Dearest Dolly, 

Knowing your intimate friendship with the wife of General 
Washington, I write to tell you of a most scandalous situation. 

I am informed that the young men at the publicke house have been 
mocking the good general regarding his iron teeth, 

Do have a word with James, and if it is true, try to discover 
whether Martha can gently persuade the great man to try 
porcelain or gold instead. 


[Includ^[Del IveFjf Clear ) fRe-addresF) 


C Stay Up 


^To: martha@washington ~ 

Subject: How George May Be Aided in His Publicke Appearances 
Bcc: abigaileadam^ 

Dearest Martha, 

Thee oughtest talk to George-^about his false teeth. 

My husband tells me the men at Fraunces Taverne 
spoke most unkindly of his appearance there. 

Such a great general and statesman as he 

deserves better treatment at the hand of his dentist. 
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Dbx (debug) Tool 



Dbx Tool is a source-level debugger for C, Pascal, and FORTRAN 77 programs. 
See the dbxtool command in the SunOS Reference Manual for inforaiation on 
how to use the debugger. 

The Dbx Tool icon is shown to the left. The Dbx Tool frame is shown in Figure 
11 - 11 . 


Figure 11-11 Dbx Tool Frame 


dbxtool ' 1 

Awaiting Execution I 

File Displayed; . /example. c Lines; 13-32 | 

1 

struct few few2 = { 3, 4, NULL, "world" } ; 
struct few fewl - { 1, 2, &few2, "hello" } ; 

/* 

* write a main program to use the structures 
*/ 

mainC) 

{ 

/* 

* declare the variable *fewp 

* to p[oint to a few-type structure 
*/ 

struct few *fewp; 

/* 

* print out a message 
*/ 

f for Cfewp » &fewl; fewp !* NULL; fewp -> next) { 

printfC"%s ", fewp -> message); 

} 

} 

[ print ][print ’")[ next ][ step ][stop at][ cont ][stop in][ clear ][ where ] 

[ up down ][ run ] 

1 

Reading symbolic information... 

Read 155 symbols 
(dbxtool) run 

Running; example 
hello world 

execution cwnpleted, exit code is 0 

program exited with 0 

(dbxtool) stop at "example.c";29 

(2) stop at "example.c";29 

(dbxtool) print fewp 

"fewp" is not active 

(dbxtool) 

a 

m 

B 



»sun 

microsystems 


Revision A of 9 May 1988 







































Chapter 11 — All About Tools 199 


Performance Meter 



\/Un 

CPU 100 


Performance Meter is a tool for observing system performance. 

The Performance Meter icon, shown on the left, is a speedometer-like gauge 
whose needles move as system conditions change. The short needle tracks aver¬ 
age performance, the long one tracks current performance. The moving display 
is updated about once a second. 

The perfomiance option being measured is shown in the lower left comer of the 
icon or frame. Its maximum value is shown in the lower right comer. For exam¬ 
ple, since CPU performance is measured as a percentage, its maximum value is 
100 . 

The Performance Meter frame, which is the same size as its icon, is a graph that 
changes as system conditions change. The ‘Tools^^Performance Meter’ puU- 
right menu contains the following options, shown in frame (open) format: 

‘Percent CPU Used’ — processor performance. 


pkts 64 


‘Ethernet Packets’ — network performance. 



‘Swapped Jobs’ — memory performance. 




d 1 sk 

40 


‘Disk Transfers’ — I/O performance. 


There are several additional options for Performance Meter. For example, it can 
monitor performance on a remote machine such as your fileserver. To change the 
display, choose another option from its menu: 

□ Move the pointer over the Performance Meter icon or frame and hold down 
the RIGHT mouse button to bring up its menu. Highlight the option you 
want, then release the mouse button. 

For more information, see the perfmeter command in the SunOS Reference 
Manual. 


^sun 

microsystems 


Revision A of 9 May 1988 





200 SunView 1 Beginner’s Guide REFERENCE 


Clock 



Clock is a tool that displays a clock face icon showing the current time of day - 
the hands move. 

You can choose either a round or a rectangular clock icon, as shown to the left. 

The SunView menu displays the icons without the hands. 


The Qock frame displays the day, full date, and year as well as the time, as 
shown in Figure 11-12. 

To update the information displayed by the Clock, use the date command 
described in the SunOS Reference Manual. To add additional Qock options, 
such as a second hand and a day-and-date display, see the clock command in 
the SunOS Reference Manual to find out what options to specify, then customize 
your SunView menu, as described in Chapter 8, to include the optional Clock 
features, 


Figure 11-12 


Clock Frame 
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SunView Terminology 


This chapter contains a summary of terms used throughout this manual. Related 
terms are grouped together under the following headings: 

□ General SunView terms, 
o Mouse and pointer terms, 
o Text terms. 

□ Scrolling terms. 

□ Menu terms. 

□ Frame and window terms. 

12.1. A Map of SunView Figure 12-1 contains a picture of a SunView screen, with arrows and labels for 

the various parts. 
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12.2, General SunVIew 

Terms 


12.3. Mouse and Pointer 

Terms 



12.4. Text Terms 



inverse video 
highlight 
alert window 

LEFT 

MIDDLE 

RIGHT 

pointer 


point 

click 

hold down 


Method of displaying text or image in white on black 

background. 

Display in inverse video. Highlighting indicates 
selected text or menu item that can be chosen. 

A panel that is displayed in rest^nse to an action you 
request It contains infonnative messages, warnings, and 
choices represented by panel buttons. 

The LEFT mouse button, used to select text, push panel 
buttons, and make choices. 

The MIDDLE mouse button, used to adjust or extend 
selections and move frames. 

The RIGHT mouse button, used to bring up menus and 
choose menu items. 

The distinctive shape, usually an arrow pointing “north¬ 
west,” whose position on the screen is moved by the 
mouse. The pointer shape is a target when it’s on the 
frame border, a right arrow when a menu is up, and an 
hourglass when you must wait for an operation to com¬ 
plete. The pointer takes other shapes when it’s in the 
scrollbar and in certain applications. 

Position the pointer by moving the mouse. 

Press and release a mouse button. 

Press a mouse button and continue to hold it down while 
performing another operation — for instance, while pre¬ 
viewing a menu or choosing a menu item. When this 
manual tells you to hold down a mouse button, keep 
holding it down until the manual tells you to release it. 


select Highlight text by pointing and clicking LEFT. Selected 

text is marked for subsequent operations. 

selection Highlighted text that is recognized by SunView for 

menu and function key operations. 

secondary selection An underlined temporary selection that you make while 

pressing a function key. 

pending-delete selection 

A grayed selection that can be deleted by typing or past¬ 
ing. 

extend the selection Adjust the current selection to include more (or less) text 
by pointing and clicking MIDDLE. 

keyboard focus Refers to the window where typing or pasting appears 

(normally the window that contains the pointer). 
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Click-to-Type keyboard focus 

Lets you click in a window to set the keyboard focus. It 
remains there, no matter where you move the pointer, 
until you click in another window. 


Pointer-in-Window keyboard focus 

The normal keyboard focus in SunView — changes 
when you move the pointer into another window. 


Mouse-to-Type keyboard focus 

Another name for Pointer-in-Window keyboard focus. 


insertion point 

The place where the next character you insert will go. 

To set the insertion point, position the pointer and click 
LEFT. 


caret 

The insertion j^int indicator. In a window that has the 
keyboard focus, the caret is a blinking black triangle. In 
a window without the keyboard focus, the caret is an 
unblinking gray diamond. 


Clipboard 

Stores text you copy or cut. 


document 

A file that is displayed in a text window. 


erase text 

Remove text from a document without changing the 

Clipboard. 

- 

delete text 

Remove text from a document and place it on the Qip- 
board. 


12,5. Scrolling Terms scroll 

Move the document up or down in a text window so that 

different portions of text are made visible. 


scrollbar 

The column at the left of a window, used to scroll the 

document in the window. 


scroll boxes 

The boxes at either end of the scrollbar. You click in 
them to move the document a line or a windowful at a 

time. 


bar 

The light gray part of the scrollbar, bounded by the 

scroll boxes. You click in the bar to position the docu¬ 
ment in the window. 


bubble 

The dark gray part of the bar. Shows the relative posi¬ 
tion of the document in the window. The height of the 
bubble in the bar is proportional to the amount of text 
that’s currently visible. 


thumb 

Scroll directly to a location in the document by using the 
MIDDLE mouse button. 
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12.6. Menu Terms menu 

menu item 
bring up a menu 
pull-right menu 

pull-right menu item 


highlight a menu item 
preview a menu 

choose a menu item 
SunView menu 

Frame menu 

Text menu 


12.7. Frame and Window frame 
Terms 

icon 

frame header 

window 

text window 
edit window 


A list of actions you can choose from. 

The name of an action in a menu. 

Hold down the RIGHT mouse button. 

A submenu you bring up by pulling right on its menu 
item. 

The menu item you pull right on in order to bring up a 
pull-right menu; for instance, you bring up tl^ Text 
menu’s ‘File=>’ pull-right menu — which contains 
several menu items — by pulling right on the ‘File=:>’ 
puU-right menu item. 

Indicate a menu item to be chosen. 

Hold down the RIGHT mouse button to bring up a menu 
and highlight various menu items, including those in 
pull-right menus. 

With the desired menu item highlighted, release the 
mouse button. 

The menu you bring up over the gray background. Con¬ 
tains menu items for starting shells, editors, and tools; 
obtaining various services; and quitting SunView. 

The menu you bring up over a frame or icon. Contains 
menu items for opening and closing, moving and resiz¬ 
ing, changing an overlapping display, and quitting the 
tool. 

The menu you bring up in a text window or command 
window. Contains menu items for file operations, edit¬ 
ing, displaying parts of a document, finding and replac¬ 
ing text, and optional extras. 

A SunView object through which a tool interacts with 
the user. The frame is surrounded by a frame border 
where you move the pointer to bring up the Frame menu. 
A frame can contain one or more windows. 

An image that represents a closed frame. 

The black stripe at the top of the frame border that con¬ 
tains information displayed by the tool, such as filename 
and directory. 

The part of the frame you work in. There are various 
types of windows. 

A window that lets you display and edit text. 

The main text window displayed by the Text Editor. 
Usually contains text from a file. 
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scratch window 

command window 

dialog 

transcript 

panel 

panel text item 
panel button 

push a panel button 
choice item 

slider 

cycle item 

choose in a choice item 


An auxiliary text window displayed by the Text Editor, 
Defaults Editor, and other tools. Can te used as a 
scratch pad for filenames and short strings of text. 

A text window that includes a command interpreter, 
such as a Command Tool window. 

The interaction between the user and the shell, as in a 
command window or a tty window. 

The record of the dialog in a command window. 

A type of window that can contain various items includ¬ 
ing panel buttons, text items, cycle items and other 
choice items, depending on the application. These items 
can contain hidden menus. 

An area in a panel where you can type and edit text. 

A representation of an action choice, such as Replace 
AH in the Find and Replace frame. 

Click LEFT on the button to make the choice. 

A panel item that lets you specify a condition, such as 
the delimiter choice buttons in the Find Marked Text 

frame and the Category cycle item in the Defaults Edi¬ 
tor. 

A type of choice item that lets you slide a marker in a 
bar to choose a setting. 

A type of choice item that lets you cycle through a set of 
choices until you come to the setting you prefer. 


The way you choose depends on the type of choice item, 
but every choice item also has a menu that you can bring 
up to make a choice. 
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Special Characters 
%% in checkpoint filename, 139, 180 
% in backup filename, 139 
& runs tool in the background, 185 
> in Text Editor icon, 82 
# keys, 164 
_ in text, 103 

I with get_selection command, 115 

A 

aborting an operation, 106 
accelerator, 161 thru 169 
alert button, 87, 169 
caret, 53, 164 
Close, 133 
Copy, 145 
Cut, 145 
erase, 164 

Find Selection=>, 50 
Find=^, 152 
for menu items, 33 
Front, Back, 163 
function key, 161 
Include File, 140 
introduction to, 29 
keyboard, 164 
Load File, 140 
menu, 161, 164, 167 
mouse button, 53, 163 
Move, 38,134, 163 
Move Caret to End, 166 
Move Caret to Start, 166 
Open, 31,133, 163 
Paste, 145 

Resize, 38, 134, 135, 163 
Set Directory, 141 
tutorial, 29 thru 53 
Undo Last Edit, 145 

Ad just_is_j5ending_delete default, 179 
adjusting a selection, 18,94, 104 
adjusting with MIDDLE mouse button, 6 
advanced selecting, 103 
Again, in Text menu, 142 
ignores Undo, 142 
used with Find, 143 
alert window, 15, 86 
accelerators, 87, 169 


alert window, continued 
arrows, 86 
buttons, 86 

for Resize and Move, 36 
alias, using tty escape sequence, 76 
All Text, in Find and Replace frame, 48, 151 
arrow keys, 78, 166 
Auto_indent default, 179 

B 

Back accelerator, 163 
Back Space key, 14, 180 
Back, in Frame menu, 32, 34, 137 
-background option in sunview command, 59 
background, SunOS job control, 185 
background, SunView 
customizing, 59 
inverse video, 60 
backup files, 139 

backward, extending selection, 20 
bar, in scrollbar, 44, 119 
basic editing, 95 
basic scrolling, 119 

Blink Owner button, in Find and Replace frame, 46, 151 

Blink Owner button, in Find Marked Text frame, 153 

block cursor, 87, 93 

bold font in frame header, 179 

bounding box, 34, 133 

brackets in text 

inserting, 142, 154 
removing, 154 
bringing up a menu, 7,125 
bringing up SunView, 3, 59 
bubble, in scrollbar, 44, 119 
button, choice, 152 
button, mouse, 6 
button, panel 

in alert window, 16 
pushing, 16, 46 

c 

C debugger, 198 

canceling a secondary selection, 106 
canceling a view, 149 
canceling an operation, 106 
canvas, 87, 193 
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Capitalize=:^>, in Text menu, 154 
Caps Lock key, 168 
caret, 13, 93, 95 

blinking triangle, 95 
display and moving, 45 
insertion point, 95 
move to end of document, 150 
move to start of document, 149 
show at top of window, 149 
caret accelerators, 164 
categories in Defaults Editor, 175 
Category cycle item, in Defaults Editor, 174 
cd command, used in SunView, 3 
Center__string_items default, 178 
Change Line Wrap=>, in Text menu, 48, 150 
changing command modes, 85 
changing defaults, 177 
changing direction with Shift key, 83 
changing keyboard focus, 73 
changing the rootmenu file, 130 
character, erasing, 96 
character, selecting, 94 
Check Printer Queue, in SunView menu, 128 
checkpoint file, 139 

Checkpoint_frequency default, 180 
choice button, 152 
choosing a menu item, 10 
Chck-to-Type keyboard focus, 73 
Click_to__Type default, 179 
chcking, 17 

chcking to select text, 103 
Clip Lines, in Text menu, 52, 150 
Clipboard, 20, 96, 145 

finding contents of, 152 
showing contents of, 152 
clipping long lines, 150 
Clock, 200 

clock command, used in SunView, 186, 200 
Close, in Frame menu, 133 
closing a menu, 8 

CmdModes=?> menu, in Text menu, 156 
cmdtool command, used in SunView, 186, 187 
command 
cd, 3 

clock, 186, 200 
cmdtool, 186, 187 
date, 200 
dbxtool, 186, 198 
default sedit, 186 
emacs, 166 
fmt, 150, 153 
fontedit, 186, 195 
get_selection, 115 
gfxtool, 186, 189 
grep, 156 
head, 98 

iconedit, 87, 186, 193 
indent, 154, 176 
lockscreen, 186 
Ipr, 51 


command, continued 
mailtool, 186 
more, 157 

perfmeter, 186, 199 
rlogin, 114 
screendump, 59 
shelltool, 186, 188 
stty, 176 
sunview, 59 
swin, 74 

textedit, 186, 191 
toolplaces, 129 
command line, 84 
command modes, 85 
command names cross-reference, 186 
Conunand Tool, 187 
Command Tool, remote login to, 129 
command window, 84 
comparison of text handling, 114 
Compatibility category, in Defaults Editor, 176 
Console buffer size default, 180 
Console frame, 5,190 
Constrained, in Frame menu, 35 
Continue, in Tty menu, 157 
Control key, 83, 106, 162 
Control panel, in Defaults Editor, 174 
Copy then Paste, in Text menu, 146 
Copy then Paste, in Tty menu, 157 
Copy, in Text menu, 145 
Copy, secondary, 106, 111 
copying 

a selection, 98 
and pasting text, 98 
between windows, 101 
copying text, 97, 110, 111 
. cshrc file, 76 
cursor, block, 87, 93 
customizing the Extras=» menu, 154 
customizing the SunView background, 59 
customizing the SunView menu, 130 
Cut function key, 96 
Cut, in Text menu, 21, 145 
Cut, secondary, 106, 112 
cutting and pasting text, 99 
cutting text, 97 
cycle item, 45, 174 
cycling, in Defaults Editor, 175 




D 

date command, used in SunView, 200 
Dbx (debug) Tool, 198 

dbxtool command, used in SunView, 186, 198 
default directory in Text Editor, 23 
default, in Defaults Editor, 175 
Default_Selection default, 178 
Defaults category, in Defaults Editor, 176 
Defaults Editor, 173 thru 181, 192 

Adjust_is_pending_delete, 179 
Auto_indent, 179 
Category cycle item, 174 
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Defaults Editor, continued 

Checkpoint_f requency, 180 

Click_to_Type, 179 

Control panel, 174 

cycling through categories, 175 

Defaults panel, 175 

Edit Item button, 175, 180 

Edit_back_char, 180 

Icon_gravity, 179 

Input/Left_Handed, 178 

interesting defaults, 178 

left-handed keyboard use, 69 

Menu/Center_string_iteins, 178 

Menu/Default_Selection, 178 

Menu/Font, 178 

Menu/Initial_Selection, 178 

Menu/Stay_up, 179 

Message panel, 175 

Quit button, 175 

quitting, 173 

Reset button, 175 

Save button, 175 

scratch window, 175 

Scratch_window, 180 

Scrollbar/Vertical_bar_placement, 179 
starting, 173 
SunView/Font, 178 
Text/Font, 178 

Text/Insert__makes_caret_visible, 180 
Text/Multi__click_space, 103 
Text/Mult i__click_timeout, 103 
Tty/Text_wraparound_size, 180 
when changes take effect, 177 
.defaults file, 174 
defaults in menus, 126 
Defaults panel, in Defaults Editor, 175 
defaultsedit command, used m SunView, 186 
Delete key, 14, 96, 180 
deleting and pasting back, 96 
deleting line breaks, 96 
deleting text, 16, 96, 112 
delimiters 

finding with ‘Find Marked Text’, 152 
matching with ‘Match Delimiter’, 153 
Destroy View, in Text menu, 149 
diagram of function keys, 69 
diamond (♦) keys, 164 
direct scrolling, 44, 120 
directory 

starting SunView from, 59 
/usr/include/images, 132, 193 
/usr/lib/fonts/f ixedwidthfonts, 178, 195 
dirojtory, setting, 23, 140 
Disable Page Mode, in Tty menu, 157 
Disable Scrolling, in Text menu, 156 
dismissing a menu, 8 

Display=> menu, in Text menu, 146 thru 150 
Display=> menu, in Text Menu 
Change Line Wrap=>, 48 
Clip Lines, 52 
Move Caret to End, 45 
Move Caret to Start, 45 


Display=> menu, in Text Menu, continued 
Show Caret at Top, 45 
Wrap at Character, 50 
Wrap at Word, 51 
displaying the caret, 45 
document, 11 

emptying, 141 
including a file, 41 
saving, 22 

Done button, in Find and Replace frame, 151 
Done button, m Find Marked Text frame, 153 
double-clicking, 17, 103 

E 

Edit Item button, 180 

Edit Item button, in Defaults Editor, 175 

edit window, 11 

Edit=> menu, in Text menu, 142 thru 146 
Edit=> menu, in Text Menu 
Cut, 21 
Paste, 21 

Show Clipboard, 20 
Undo Last Edit, 24 
Edit_back_char default, 180 
(edited) in frame header, 23 
editing 

basic, 95 

enabling in command window, 156 
shortcuts, 108 
imdoing, 24,102 
editing defaults, 180 
editing panel text item, 86 
editor, 191 

Defaults Editor, 192 
Font Editor, 195 
Icon Editor, 193 
Text Editor, 10,191 

Editors=> menu, in SunView menu, 128, 191 thru 196 
emacs command, used in SunView, 166 
Einbolden_Labels default, 179 
Empty Document, in Text menu, 15, 141 
Enable Editing, in Text menu, 156 
Enable Page Mode, in Tty menu, 75, 157 
Enable Scrolling, in Text menu, 156 
End key, 166 
erase accelerators, 164 
erasing text, 14,96 
Esc key, 141 
escape sequence, 75 
escape sequences in . tty swrc, 75 
Exit SunView, in SunView menu, 53, 62, 129 
exiting SunView, emergency, 62 
exposing a frame, 32 
exposing and hiding frames, 87 
extending a selection, 18, 94 
extending with MIDDLE mouse button, 6 
Extras=> menu, in Text menu, 153 thru 154 
customizing, 154 
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F 

FI key, 168 
l>field<l, 153 
file 

backup, 139 

. cshrc, 76 
. defaults, 174 
including in text window, 140 
. indent .pro, 154 
loading, 40,140 
rootmenu, 130 
saving, 22,139 
. suntools, 129 
. sunview, 61, 88, 129 
. textswrc, 77 
. ttyswrc, 74 

/usr/lib/.text_extras_menu, 154 
/usr/lib/def aults, 174 
/usr/lib/rootmenu, 130 
File=> menu, in Text menu, 14, 139 thru 142 
Empty Document, 15 
Include File, 41 
Load File, 40 
Set Directory, 23 
Store as New File, 22 
filtering selections, 84 
Find and Replace frame, 46,150 
Find Clipboard=>, in Text menu, 152 
Find function key, 152 
Find Marked Text, in Text menu, 152 
Find Selection=», in Text menu, 152 
Find text item, in Find and Replace frame, 47,151 
Find then Replace, in Find and Replace frame, 151 
Find=^ menu, in Text menu, 150 thru 153 
finding text, 45 

Finishing Up=> menu, in Text menu, 141 
flash lines, 9 

fmt command, used in SimView, 150, 153 
font, 178 

bold in frame header, 179 
Font default, 178 
Font Editor, 195 

fontedit command, used in SunView, 186, 195 

Format, in Text menu, 153 
FORTRAN debugger, 198 
frame, 81 thru 88 

bringing to front, 137 
closing, 8 

command name, 11 
(edited), 23 
enlarging, 136 
exposing, 32, 87 
Find and Replace, 45,46 
Find Marked Text, 152 
font in frame header, 179 
frame header, 8, 11, 23, 82 
grabbing to move or resize, 35 
hiding, 32, 87 
moving, 34, 87, 163 
opening, 8 

opening, accelerator, 163 


frame, continued 

overlapping, 31, 87 
pop-up, 82 
quitting, 138 
rescuing, 32 
resizing, 34, 87,163 
sending to back, 137 
subframe, 82 
Text Editor, 11 
tool name, 11 
uncovering, 32 
zooming, 136 

Frame menu, 8, 133 thru 138 
Back and Front, 32, 34 
FuUScreen, 39 
function keys for, 34 
pop-up frame, 45 
Props, 10 
Resize=>, 35 
UnZoom, 39 
Zoom, 39 

Front accelerator, 163 
Front, in Frame menu, 32,34, 137 
FuUScreen, in Frame menu, 39, 136 
function key, 33 

accelerators, 161 
Again, 142 
binding to a filter, 74 
Cut, 96 
Delete, 14 
diagram, 69 
Find, 50,152 
labels, 69 

left-handed use, 69 
Paste, 96 
remapping, 74 

secondary selection with, 104 
Stop, 106, 169 

G 

get_selection command, used in SunView, 115 

gfxtool command, used in SunView, 186, 189 

glossary, 203 thru 208 

grabbing a frame to move or resize it, 35 

Graphics Tool, 189 

gravity, icon, 9 

grayed menu item, 10, 21,126,138 

grayed selection, 104,106 

grep command, used in SxmView, 156 

H 

head command, used in SunView, 98 
header, frame, see frame 
hiding a frame, 32 
highlighting, 7 

grayed for pending-delete, 106 
Home key, 166 
hot spot in pointer, 92 
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I 

Icon Editor, 193 
icon files, 132 
icon gravity, 9 

I con_gravity default, 179 

iconedit command, used in SunView, 87,186, 193 

icons in menus, 53, 132 

images directory, 132 

Include File, in Text menu, 41, 140 

including a file, 41 

Indent category, in Defaults Editor, 176 

indent command, used in SunView, 154, 176 

. indent. pro file, 154 

Initial_Selection default, 178 

Input category, in Defaults Editor, 176 

input focus, see keyboard focus 

Input/Lef t_Handed default, 178 

Insert Brackets=>, in Text menu, 154 

Insert_makes_caret_visible default, 180 

inserting text, 19, 95 

insertion point, 13, 19, 95 

inverse video, 7, 60 

K 

key 

arrow, 166 
Backspace, 14, 180 
Caps Lock, 168 
Control, 83, 106, 162 
Delete, 14, 96, 180 
diamond, 164 
End, 166 
Esc, 140, 141 
FI, 168 
Home, 166 
Line Feed, 96 
Meta(#),71,72, 164 
R13,166 
R7,166 
Return, 96,169 
Shift, 162 
Stop, 169 

keyboard, 65 thru 78 
accelerators, 164 
function keys, 33 

Input/Left_Handed default, 178 
labels, 69 

labels for Type2, 72 
labels for Type3, 71 
labels for Type4, 70 
left-handed user, 6 
Type2, 68 
Type3, 67 
Type4, 66 

keyboard accelerators, 33 
keyboard focus, 13 
keyboard focus, changing, 73 


L 

labels, 69 

Type2 keyboard, 72 
Type3 keyboard, 71 
Type4 keyboard, 70 
leaving SunView, 53, 62, 129 
LEFT mouse button, 6 
left-handed function keys, 69 
left-handed user, 6 
Left_Handed default, 178 
lessons, 3 thru 53 
limerick, 16 
line 

getting line number, 146 
selecting by number, 146 
line break, deleting, 96 
Line Feed key, 96 
line, erasing, 96 
list, reordering, 113 
Load File, in Text menu, 40, 140 
loading a file, 40 
Lock Screen, 25, 30, 62 
Lock Screen, in SunView menu, 129 
lockscreen command, used in SunView, 25, 186 
login, 30 

login, remote, 129 

Ipr command, tised in SunView, 51 

M 

Mail category, in Defaults Editor, 176 
Mail Tool, 51,197 

mailtool command, used in SunView, 186 
mapping keys, 74 

Match Delimiter, in Text menu, 153 
mechanical mouse, 92 
menu, 125 thru 157 
accelerators, 161 
bringing up, 7, 125 

Center_string_items default, 178 
closing, 8 

Cmd Modes =>, 156 
cycle item’s, 48 

Default_Selection default, 178 

defaults, 126 

dismissing, 8 

Display=>, 146 

Edit=>, 142 

Extras=>, 153 

File=>, 14 

font in, 178 

Frame, 8,45, 133 thru 138 
grayed item, 10, 126 
icons in, 53 
in panel, 48, 127 

Initial_Selection default, 178 

opening, 7 

popping up, 10 

previewing, 12 

previewing in panel, 48 

pull-right, 14 

stay-up, 8, 53,127 


-213 



Index — Continued 


menu, continued 

Stay_up default, 179 
SunView, 24, 128 thru 132 
Text, 12,139 thru 156 
Tty, 157 

menu accelerators, 164, 167 

Menu category, in Defaults Editor, 176 

menu item 

choosing, 10 
grayed, 21 

selection required, 21 
Message panel, in Defaults Editor, 175 
Meta (❖) keys, 71, 72, 164 
MIDDLE mouse button, 6 
mnemonics for caret accelerators, 166 
more command, used in SunView, 157 
mouse, 5,91 
clicking, 17 

keyboard accelerators, 53 
left-handed user, 6 
mechanical, 92 
optical, 91 
pointer stuck, 6 
mouse button 
clicking, 6 
holding down, 6 
pressing, 6 

mouse button accelerators, 163 
Mouse-to-Type keyboard focus, 73 
mousing ahead, 84 

Move Caret to End, in Text menu, 45, 150 
Move Caret to Start, in Text menu, 45, 149 
Move, in Frame menu, 133 
accelerator, 38, 163 
alert window, 36 
Constrained, 134 
Unconstrained, 134 
moving a frame, 34, 87 
moving a selection, 99 
moving text, 21, 110, 111 
moving the caret, 45 

from the keytx)ard, 164 
multi-clicking, 103, 104 
Multi__click__space default, 103 
Multi_click_timeout default, 103 

N 

new document, 141 
new file, saving, 22,139 
newline character, 96 

o 

Open accelerator, 163 
Open, in Frame menu, 133 
opening 

frame, 8 
menu, 7, 8 
optical mouse, 91 
overlapping frames, 31, 87 


P 

pad, 5 

page mode, in tty window, 157 
paging in a window, 120 
panel, 85 

alert window, 15, 86 
canvas, 87 

editing text item in, 86 
menus in, 48,127 
panel button, 46 
panel items, 45 
text item, 46 
Pascal debugger, 198 
Paste function key, 96 
Paste, in Text menu, 145 
Paste, secondary, 104, 110 
pasting text, 95,97 
pending-delete selection, 53, 106 
percent sign, 139 

perfmeter command, used in SunView, 186, 199 
Performance Meter, 199 

pipe (I ) symbol with get_selection command, 115 
piping, 150 

piping a selection to a command, 115 
pointer, 5, 92 

stop sign, 157 
target, 8 

pointer shapes, 92 

Pointer-in-Window keyboard focus, 73 

pop-up frame, 82 

popping up a menu, 10 

preserving the screen, 25 

Pretty-print C, in Text menu, 154 

previewing a menu, 12,48 

primary selection, 93 

Print Selected Text, 25 

Print Selected Text, in SunView menu, 129 

printing, 25 

checking the queue, 128 
Printing=>, in SunView menu, 128 
privacy, 25 

proportional scrolling, 44 
Props, in Frame menu, 138 
puU-right menu, 14 
pushing a button, 16 
pushing a panel button, 6,46 

Q 

quadruple-clicking, 17, 103 

question mark, 15 

quick editing, 108 

Quit button, in Defaults Editor, 175 

Quit, in Frame menu, 138 

quitting SunView, 62, 129 

quoting commands in text, 168 
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R 

R13 key, 166 
R7 key, 166 
rearranging text, 113 
Redisplay All, in SunView menu, 128 
Redisplay, in Frame menu, 138 
refreshing the screen, 138 
reinserting deleted text, 96 
remapping keys, 74 

Remote Login=», in SunView menu, 129 
Remove Brackets=», in Text menu, 154 
repeating an operation, 142 
Replace l>field<l=>, in Text menu, 153 
Replace All, in Find and Replace frame, 151 
Replace text item, m Find and Replace frame, 47, 151 
Replace then Find, in Find and Replace frame, 151 
replacing text, 45, 46,100,110, 111 
rescuing a frame, 32 
Reset button, in Defaults Editor, 175 
Resize accelerator, 135, 163 
Resize, in Frame menu, 35, 134 
accelerator, 38 
alert window, 36 
Constrained, 135 
Unconstrained, 134 
resizing a frame, 34, 87 
resizing a scratch window, 83, 135 
Return character, 48 
Return key, 96, 169 
RIGHT mouse button, 6 
rlogin command, used in SunView, 114 
rootmenu file, 130, 132 
ruiming SunView, 3 

s 

Save button, in Defaults Editor, 175 
Save Current File, in Text menu, 139 
save frequently, 139 

Save Layout, in SunView menu, 61, 88, 129 
saving 

a document, 22 
automatic backup, 139 
changes in Defaults Editor, 177 
checkpoint file, 139 
screen layout, 88, 129 
shortcuts, 141 

scratch window, 11, 22, 83, 175 
changing size, 83 
resizing, 135 
scrollbar, 42 

Scratch_window default, 180 
screen 

locking, 62,129 
refreshing, 138 
saving the layout, 61, 129 
screen fonts, 178 
screen, locking, 25 
screen, unlocking, 30 

screen dump command, used in SunView, 59 


scroU box, 42, 119 
scrollbar, 42, 119 
bar, 44 

bubble, 44,119 
in scratch window, 42 
scroU box, 42 

Vertical_bar_placement, 179 
Scrollbar category, in Defaults Editor, 176 
scrolldefaults, 176 
scrolling, 42, 119 thru 121 
a line, 119 
awindowful, 119 
backward, 120 
basic, 119 
by line, 43 
by windowful, 43 
continuous, 120 
direct, 120 
directly, 44 

disabling in command window, 156 
down, 120 

enabling in command window, 156 

forward, 120 

paging, 120 

proportionally, 44 

returning to previous location, 120 

thumbing, 120 

to position in document, 120 

up, 120 

windowful, 120 
secondary Copy, 106, 111 
secondary Cut, 106, 112 
secondary Paste, 104, 110 
secondary selection, 104 thru 113 
canceling, 106 
problem, 106 
stuck, 106 

with Find function key, 106, 152 
Select Line at Number, in Text menu, 146 
selecting 

a character, 94 
advanced, 103 
basic, 93 

by line number, 146 
extending, 94 
word, 17 

selecting text, 16, 94 
selecting with LEFT mouse button, 6 
selection, 91 thru 116 
adjusting, 18, 94 
caret, 95 
copying, 98 
extend by wiping, 18 
extending, 18 
extending backward, 20 
extending multi-click, 104 
filtering, 84 
finding, 152 
get_selection, 115 
highlighted, 7 
highlighting characters, 95 
moving, 99 
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selection, continued 

pending-delete, 53, 106 
piping to a command, 115 
primary, 93 
printing, 129 
problem, 106 
replacing, 100 
required for menu item, 21 
secondary, IQAthru 113 
stuck on secondary selections, 106 
Services=> menu, in SunView menu, 128 
Services=?>, in SunView menu, 25 
Set Directory, in Text menu, 23, 140 
Shell Tool, 188 

Shell Tool, remote login to, 129 
shells, 186 

Shells=i> menu, in SunView menu, 128, 186 thru 191 
shelltool command, used in SunView, 186, 188 
Shift key, 162 

Shift Lines=>, in Text menu, 154 
Show Caret at Top, in Text menu, 45, 149 
Show Clipboard, in Text menu, 20 
Show ClipboaTd=», in Text menu, 146, 152 
slider, 196 

Split View, in Text menu, 147 
standard input, 153 
standard output, 153 
starting a tool, 185 
starting SunView, 3 
stay-up menu, 8 
stay-up menus, 53,127 
StaY_up default, 179 
stdin, 153 
stdout, 153 

Stop function key, 106, 169 

stop sign pointer, 157 

stopping a secondary selection, 106 

stopping an operation, 106 

Store as New File, in Text menu, 22,139 

stty command, used in SunView, 176 

Stuff, in Tty menu, 108, 146, 157 

subframe, 82 

. suntools file, 129 

SunView 

Cl±ck_to_Type, 179 
emergency exit, 62 
exiting, 53, 62,129 
font, 178 

I con_gr avity, 179 
starting, 3 

starting and exiting, 59 thru 62 
tools, 4, 24,186 

SunView category, in Defaults Editor, 177 
sunview command, to start SunView, 59 
. sunview file, 61, 88 , 129 
SunView menu, 24, 128 thru 132 
adding icons, 132 
customizing, 130 
editors, 128 
Exit SunView, 62 


SunView menu, continued 
Lock Sca-een, 62 
printing, 25 
Save Layout, 61 
services, 128 
shells, 128 
tools, 128 
swapping text, 113 

swin command, used in SunView, 74 

T 

Tab character, 50 
target pointer, 8 
terminology, 203 thru 208 
text 

copying, 97,110, 111 
cutting, 97 

deleting, 16, 96, 97, 112 
editing, 95 
erasing, 14, 96 
filtering, 84 

finding and replacing, 45 
font, 178 

handling in different windows, 114 

in panel, 86 

inserting, 19, 95 

long lines, 48 

moving, 21, 110, 111 

pasting, 95, 97 

quick editing, 108 

quoting commands, 168 

replacing, 46,100, 110, 111 

saving, 22 

scrolling, 119 

searching, 45 

selecting, 16, 93 

swapping, 113 

wrapping, 48 

Text category, in Defaults Editor, 177 
Text Editor, 10,191 
document, 11 
frame, 11 
text item, 46 
text item in panel, 45 
Text menu, 12, 139 thru 156 
Cmd Modes=> menu, 156 
Display=> menu, 146 thru 150 
Edit=» menu, 142 thru 146 
Extras=> menu, 153 thru 154 
File=» menu, 139 thru 142 
Fmd=>' menu, 150 thru 153 
text window, 11, 12, 77, 82 
scratch window, 22 
. text_extras_menu file, 154 
Tty/Text_wraparound_size, 180 
text edit command, used in SunView, 186, 191 
. textswrc file, 77 
thumbing, 120 

To End, in Find and Replace frame, 48, 151 
toggle, 10 

Open and Close, 133 
toggling, 162 
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tool, 185 thru 2(X) 

Clock, 200 
Console, 5 

Dbx (debug) Tool, 198 
editors, 191 
in Sun View menu, 24 
Mail Tool, 197 
Performance Meter, 199 
starting, 185 

Tools=> pull-right menu, 128 
tool names, 186 

toolplaces command, used in SunView, 129 

Tools=> menu, in SunView menu, 128, 196 thru 200 

triple-clicking, 17, 103 

Tty category, in Defaults Editor, 177 

tty escape sequences, 75 

Tty menu, 157 

tty window, 74, 87 

.ttyswrc error, 75 

. ttyswrc file, 74 

tutorial, 3 thru 53 

Type2 keyboard, 68 

Type2 keyboard labels, 72 

Type3 keyboard, 67 

Type3 keyboard labels, 71 

Type4 keyboard, 66 

Type4 keyboard labels, 70 

typing all capital letters, 168 

u 

Unconstrained, in Frame menu, 35 

uncovering a frame, 32 

underlining for secondary selection, 104 

underscore (_) in text, 103 

Undo All Edits, in Text menu, 145 

Undo Last Edit, in Text menu, 24, 145 

Undo operation, 102 

Undo=», in Text menu, 145 

undoing editing, 102 

undoing scrolling, 120 

undoing, warning, 24 

UnZoom, in Frame menu, 39, 136 

/usr/include/images directory, 132, 193 

/usr/lib/ . text_extras_menu file, 154 

/usr/lib/defaults file, 174 

/usr/lib/fonts/fixedwidthfonts directory, 178, 195 
/usr/lib/rootmenu file, 130 

V 

Vertical_bar_placement default, 179 
view, destroying, 149 
view, splitting, 147 

w 

What Line Number?, in Text menu, 146 
window, 81 thru 88 
command, 84 
edit, 11 
emptying, 14 


window, continued 
resizing, 135 
scratch, 11, 83, 175 
text, \ 82 

text handling comparison, 114 
tty, 74, 87 

windows, copying between, 101 
wiping to extend a selection, 18 
word 

defined, 103 
selecting, 17 
wrapping at, 150 
word, erasing, 96 

Wrap at Character, in Text menu, 50, 150 
Wrap at Word, in Text menu, 51, 150 
wrapping long lines, 150 
wrapping text, 48 

z 

Zoom, in Frame menu, 39, 136 
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Type4 Keyboard 



Menu Action 


Stop 

‘Props’ 

‘Front’, ‘Back’ 

‘Open’, ‘Close’ 

‘Find=>Find Selection=>Forward’, 
‘Find=>Find Clipboard=>Forward’ 
‘Edit=>Again’ 

‘Edit=>Undo=>Undo Last Edit’ 
‘Edit=>Copy’ 

‘Edit=>Paste’ 

‘Edit=>Cut’ 


‘Back’ 

‘Find=>Find Selection=^BackwaTd’, 
‘Find=^>Find Clipboard=>Backward’ 
‘Find=>Fmd and Replace’ 


Other Keyboards 



[fSI] 


[fOJ 



























Text Handling in Windows and Panels 














































Other Keyboard Accelerators 
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